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) / 200 tokens (new)
GET/api/v1/news0 (cache) / 200 tokens (new)
GET/api/v1/youtube0 (cache) / 1-800 tokens (new)
GET/api/v1/reddit0 (cache) / 1-200 tokens (new)
GET/api/v1/deep-analysis0 (cache) / 200 tokens (new)
GET/api/v1/trend-sparkFree
GET/api/v1/usageFree

Token Pricing

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

ModuleToken CostNotes
Keyword Search (Standard)100 tokens~20-40 PAA nodes (0 if cached)
Keyword Search (Deep)300 tokens~60-100 PAA nodes (0 if cached)
Shopping Intelligence200 tokensProduct listings + AI insights (0 if cached)
News Pulse200 tokensNews articles + AI summary (0 if cached)
YouTube Signals1-800 tokensBased on maxVideos (0 if cached)
Reddit Signals1-200 tokensBased on maxPosts (0 if cached)
Deep Analytics200 tokensComprehensive analysis (0 if cached)
Trend Spark (AI Outline)100 tokensWeb UI only
Node Expansion100 tokensExpand any PAA node
Trends / UsageFreeAlways free

Error Codes

StatusErrorDescription
400Bad RequestMissing or invalid parameters
401UnauthorizedInvalid, missing, or revoked API key
402Payment RequiredInsufficient tokens — contact admin to top up your account
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.