API Documentation

Querify API v1

Access Querify's full SEO intelligence suite programmatically. The API provides 9 endpoints covering keyword analysis, Google Trends, shopping intelligence, news monitoring, YouTube & Reddit signals, deep analytics, and account management. All endpoints require API key authentication.

Dual API Modes

Choose between Lite mode (70-90% smaller responses, perfect for AI clients) or Full mode (complete data with all insights). Select your preferred mode when creating an API key.

Authentication

Bearer token (API key)

Rate Limits

60/min, 1,000/day per key

Base URL

https://tryquerify.ai/api/v1

Quick Start

1. Generate an API key from the API Keys page.

2. Include your key in the Authorization header:

Authorization: Bearer km_YOUR_API_KEY

3. Make your first request:

curl -H "Authorization: Bearer km_YOUR_API_KEY" \
  "https://tryquerify.ai/api/v1/trends?geo=US&limit=5"

API Modes Comparison

FeatureLite ModeFull Mode
Response Size70-90% smallerComplete data
Item Limits10 items per endpoint50+ items per endpoint
AI InsightsExcludedIncluded
Comments/DetailsExcludedIncluded
Best ForAI clients, LLMsComprehensive analysis

Code Examples

Python

import requests

API_KEY = "km_YOUR_API_KEY"
BASE_URL = "https://tryquerify.ai/api/v1"

headers = {"Authorization": f"Bearer {API_KEY}"}

# Get trending topics
trends = requests.get(
    f"{BASE_URL}/trends",
    headers=headers,
    params={"geo": "US", "limit": 10}
).json()

for topic in trends["topics"]:
    print(f"{topic['title']}: {topic['searchVolume']}")

# Get keyword analysis
search = requests.get(
    f"{BASE_URL}/search",
    headers=headers,
    params={"term": "wireless earbuds", "depth": "standard"}
).json()

if search["success"]:
    for node in search["results"]:
        print(f"[{node['intent']}] {node['label']}")

Node.js

const API_KEY = "km_YOUR_API_KEY";
const BASE_URL = "https://tryquerify.ai/api/v1";

const headers = {
  "Authorization": `Bearer ${API_KEY}`,
};

// Get trending topics
const trends = await fetch(
  `${BASE_URL}/trends?geo=US&limit=10`,
  { headers }
).then(r => r.json());

trends.topics.forEach(topic => {
  console.log(`${topic.title}: ${topic.searchVolume}`);
});

// Get shopping data
const shopping = await fetch(
  `${BASE_URL}/shopping?term=wireless+earbuds`,
  { headers }
).then(r => r.json());

if (shopping.success) {
  console.log(`Price: $${shopping.priceMin/100} - $${shopping.priceMax/100}`);
  console.log(`Top sellers: ${shopping.topSellers.join(", ")}`);
}

Endpoints(9 total)

GET/api/v1/shopping0 (cache) / 2 credits (new)
GET/api/v1/news0 (cache) / 2 credits (new)
GET/api/v1/youtube0 (cache) / 1-8 credits (new)
GET/api/v1/reddit0 (cache) / 1-2 credits (new)
GET/api/v1/deep-analysis0 (cache) / 2 credits (new)
GET/api/v1/trend-sparkFree
GET/api/v1/usageFree

Credit Pricing

API read endpoints return cached data at no credit cost. Credits are consumed only when generating fresh data via the web UI. Below is the credit cost for each module:

ModuleCredit CostNotes
Keyword Search (Standard)1 credit~20-40 PAA nodes (0 if cached)
Keyword Search (Deep)3 credits~60-100 PAA nodes (0 if cached)
Shopping Intelligence2 creditsProduct listings + AI insights (0 if cached)
News Pulse2 creditsNews articles + AI summary (0 if cached)
YouTube Signals1-8 creditsBased on maxVideos (0 if cached)
Reddit Signals1-2 creditsBased on maxPosts (0 if cached)
Deep Analytics2 creditsComprehensive analysis (0 if cached)
Trend Spark (AI Outline)1 creditWeb UI only
Node Expansion1 creditExpand any PAA node
Trends / UsageFreeAlways free

Error Codes

StatusErrorDescription
400Bad RequestMissing or invalid parameters
401UnauthorizedInvalid, missing, or revoked API key
402Payment RequiredInsufficient credits — top up your account to continue
404Not FoundNo results found for this query
429Too Many RequestsRate limit exceeded (60/min or 1,000/day)
500Internal Server ErrorUnexpected server error — please retry or contact support

Client Libraries

Official SDKs are coming soon. In the meantime, use any HTTP client library (Python requests, Node.js fetch, Go net/http, etc.) to interact with the API. All endpoints follow REST conventions and return JSON responses with consistent structure.