Loading XiaoFlow

Preparing intelligence engine…

XiaoFlowXiaoFlow

Documentation

API Reference

Access our data through the API.

Quickstart

Secure your requests by including an Authorization bearer token in every header.

Base endpoint

https://api.xiaoflow.com/api

Authentication

Authorization: Bearer YOUR_TOKEN

MCP

XiaoFlow Official MCP Intelligence Protocol

Seamlessly integrate XiaoFlow's enterprise Google Ads search intelligence, high-intent keyword metrics, and 48-month historical trends directly into Claude, ChatGPT, Cursor, and terminal AI agents.

01 Integration Setup

Trend Optimization

Use the `historical=1` parameter only when you need month-by-month search volume. Retrieving 48 months of data is compute-intensive and may increase response times.

Smart Caching

Our system automatically caches results for 30 days. Re-requesting the same keyword with the same location/language within this window will not deduct additional units.

API Endpoints

GET/api/v1/keywords

1 Compute Unit / Request

Get real-time keyword data and market insights. New keywords are automatically indexed for your search.

Property	Type	Description
keyword	string	Search term (e.g."wedding rings").
url	string	Page URL for content analysis.
site	string	Website domain to map.
location_id	string	Location ID or ISO code (e.g., 2840 or US).
language_id	string	Language ID or code (e.g., 1000 or en).
historical	boolean	Enable historical trend data (0 or 1).
date_range	number	Number of months of history (12, 24, 48).

Implementation Example

curl -G "https://api.xiaoflow.com/api/v1/keywords" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d keyword=wedding%20rings \
  -d location_id=US \
  -d historical=1 \
  -d date_range=24

POST/api/v1/keywords/ideas

1 Compute Unit / Request

Generate new keyword ideas based on a seed keyword, URL, or domain.

Property	Type	Description
keyword •	string	Seed keyword (required).
url	string	Seed URL.
site	string	Seed domain.
location_id	string	Location ID.
language_id	string	Language ID.
historical	boolean	Include historical trends for generated ideas.

Implementation Example

curl -X POST "https://api.xiaoflow.com/api/v1/keywords/ideas" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "keywords": ["wedding rings"],
  "location_id": "us",
  "language_id": "en",
  "historical": true
}'

POST/api/v1/keywords/bulk

1 Compute Unit / Request

High-throughput bulk metrics retrieval for unlimited keyword lists with automatic batching.

Property	Type	Description
keywords •	array	List of keywords to analyze.
location_id	string	Location ID or ISO code.
language_id	string	Language ID or code.
historical	boolean	Enable historical trend data (0 or 1).
date_range	number	Number of months of history (12, 24, 48).

Implementation Example

curl -X POST "https://api.xiaoflow.com/api/v1/keywords/bulk" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "keywords": ["wedding rings", "diamond rings"],
  "location_id": "US",
  "historical": 1,
  "date_range": 12
}'

POST/api/v1/keywords/autocomplete

1 Compute Unit / Request

Multi-engine autocomplete keyword expansion (Google, Bing, YouTube, Amazon) across A-Z alphabet, questions, prepositions, and comparisons with metrics enrichment.

Property	Type	Description
keyword •	string	Seed keyword (e.g. "running shoes").
engine	string	Engine: "google", "bing", "youtube", "amazon" (default: google).
country	string	Country ISO code (e.g. "US", "GB").
language	string	Language code (e.g. "en", "zh").
include_metrics	boolean	Whether to enrich suggestions with search volume & CPC (true/false).

Implementation Example

curl -X POST "https://api.xiaoflow.com/api/v1/keywords/autocomplete" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "running shoes",
  "engine": "google",
  "country": "US",
  "language": "en",
  "include_metrics": true
}'

GET/api/v1/keywords/bing/suggestions

1 Compute Unit / Request

Get Microsoft Advertising keyword suggestions, monthly search volume, competition, and suggested CPC bid.

Property	Type	Description
keyword •	string	Seed keyword (e.g. "cloud hosting").
country_code	string	Target country code (e.g. "US", "GB").
language	string	Language code (e.g. "en").
max_results	number	Maximum results to return (e.g. 50).

Implementation Example

curl -G "https://api.xiaoflow.com/api/v1/keywords/bing/suggestions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d keyword=cloud%20hosting \
  -d country_code=US

POST/api/v1/keywords/yandex/suggestions

1 Compute Unit / Request

Get Yandex Wordstat related queries and last-30-day search counts from seed terms.

Property	Type	Description
seeds •	string[]	Seed keywords (JSON array or newline-separated).
regions	number[]	Wordstat region IDs (e.g. [213] for Moscow).
devices	string[]	Device filter: all, desktop, phone, tablet.

Implementation Example

curl -X POST "https://api.xiaoflow.com/api/v1/keywords/yandex/suggestions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"seeds":["яндекс"],"regions":[213],"devices":["all"]}'

GET/api/v1/keywords/pinterest/trending

1 Compute Unit / Request

Explore trending visual search keywords, rising curves, and seasonal search spikes on Pinterest.

Property	Type	Description
country	string	Target country code (e.g. "US", "GB", "CA").
interests	string	Vertical interest category filter.

Implementation Example

curl -G "https://api.xiaoflow.com/api/v1/keywords/pinterest/trending" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d country=US

GET/api/v1/keywords/pinterest/country-metrics

1 Compute Unit / Request

Retrieve country-level Pinterest audience metrics, keyword volume, and demographic distribution.

Property	Type	Description
keywords •	string	Comma-separated keywords (e.g. "home decor,outfit ideas").
country	string	Target country code (e.g. "US").

Implementation Example

curl -G "https://api.xiaoflow.com/api/v1/keywords/pinterest/country-metrics" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d keywords=home%20decor \
  -d country=US

GET/api/v1/keywords/reddit/suggestions

1 Compute Unit / Request

Get official Reddit Ads keyword suggestions, community discussion topics, and monthly view counts.

Property	Type	Description
keywords •	string	Seed keywords (e.g. "gaming laptop").
country	string	Country code (e.g. "US").

Implementation Example

curl -G "https://api.xiaoflow.com/api/v1/keywords/reddit/suggestions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d keywords=gaming%20laptop \
  -d country=US

Loading XiaoFlow

Preparing intelligence engine…

Documentation

API Reference

Access our data through the API.

Quickstart

Secure your requests by including an Authorization bearer token in every header.

Base endpoint

https://api.xiaoflow.com/api

Authentication

Authorization: Bearer YOUR_TOKEN

MCP

XiaoFlow Official MCP Intelligence Protocol

Seamlessly integrate XiaoFlow's enterprise Google Ads search intelligence, high-intent keyword metrics, and 48-month historical trends directly into Claude, ChatGPT, Cursor, and terminal AI agents.

01 Integration Setup

Trend Optimization

Use the `historical=1` parameter only when you need month-by-month search volume. Retrieving 48 months of data is compute-intensive and may increase response times.

Smart Caching

Our system automatically caches results for 30 days. Re-requesting the same keyword with the same location/language within this window will not deduct additional units.

API Endpoints

GET/api/v1/keywords

1 Compute Unit / Request

Get real-time keyword data and market insights. New keywords are automatically indexed for your search.

Property	Type	Description
keyword	string	Search term (e.g."wedding rings").
url	string	Page URL for content analysis.
site	string	Website domain to map.
location_id	string	Location ID or ISO code (e.g., 2840 or US).
language_id	string	Language ID or code (e.g., 1000 or en).
historical	boolean	Enable historical trend data (0 or 1).
date_range	number	Number of months of history (12, 24, 48).

Implementation Example

curl -G "https://api.xiaoflow.com/api/v1/keywords" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d keyword=wedding%20rings \
  -d location_id=US \
  -d historical=1 \
  -d date_range=24

POST/api/v1/keywords/ideas

1 Compute Unit / Request

Generate new keyword ideas based on a seed keyword, URL, or domain.

Property	Type	Description
keyword •	string	Seed keyword (required).
url	string	Seed URL.
site	string	Seed domain.
location_id	string	Location ID.
language_id	string	Language ID.
historical	boolean	Include historical trends for generated ideas.

Implementation Example

curl -X POST "https://api.xiaoflow.com/api/v1/keywords/ideas" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "keywords": ["wedding rings"],
  "location_id": "us",
  "language_id": "en",
  "historical": true
}'

POST/api/v1/keywords/bulk

1 Compute Unit / Request

High-throughput bulk metrics retrieval for unlimited keyword lists with automatic batching.

Property	Type	Description
keywords •	array	List of keywords to analyze.
location_id	string	Location ID or ISO code.
language_id	string	Language ID or code.
historical	boolean	Enable historical trend data (0 or 1).
date_range	number	Number of months of history (12, 24, 48).

Implementation Example

curl -X POST "https://api.xiaoflow.com/api/v1/keywords/bulk" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "keywords": ["wedding rings", "diamond rings"],
  "location_id": "US",
  "historical": 1,
  "date_range": 12
}'

POST/api/v1/keywords/autocomplete

1 Compute Unit / Request

Multi-engine autocomplete keyword expansion (Google, Bing, YouTube, Amazon) across A-Z alphabet, questions, prepositions, and comparisons with metrics enrichment.

Property	Type	Description
keyword •	string	Seed keyword (e.g. "running shoes").
engine	string	Engine: "google", "bing", "youtube", "amazon" (default: google).
country	string	Country ISO code (e.g. "US", "GB").
language	string	Language code (e.g. "en", "zh").
include_metrics	boolean	Whether to enrich suggestions with search volume & CPC (true/false).

Implementation Example

curl -X POST "https://api.xiaoflow.com/api/v1/keywords/autocomplete" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "running shoes",
  "engine": "google",
  "country": "US",
  "language": "en",
  "include_metrics": true
}'

GET/api/v1/keywords/bing/suggestions

1 Compute Unit / Request

Get Microsoft Advertising keyword suggestions, monthly search volume, competition, and suggested CPC bid.

Property	Type	Description
keyword •	string	Seed keyword (e.g. "cloud hosting").
country_code	string	Target country code (e.g. "US", "GB").
language	string	Language code (e.g. "en").
max_results	number	Maximum results to return (e.g. 50).

Implementation Example

curl -G "https://api.xiaoflow.com/api/v1/keywords/bing/suggestions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d keyword=cloud%20hosting \
  -d country_code=US

POST/api/v1/keywords/yandex/suggestions

1 Compute Unit / Request

Get Yandex Wordstat related queries and last-30-day search counts from seed terms.

Property	Type	Description
seeds •	string[]	Seed keywords (JSON array or newline-separated).
regions	number[]	Wordstat region IDs (e.g. [213] for Moscow).
devices	string[]	Device filter: all, desktop, phone, tablet.

Implementation Example

curl -X POST "https://api.xiaoflow.com/api/v1/keywords/yandex/suggestions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"seeds":["яндекс"],"regions":[213],"devices":["all"]}'

GET/api/v1/keywords/pinterest/trending

1 Compute Unit / Request

Explore trending visual search keywords, rising curves, and seasonal search spikes on Pinterest.

Property	Type	Description
country	string	Target country code (e.g. "US", "GB", "CA").
interests	string	Vertical interest category filter.

Implementation Example

curl -G "https://api.xiaoflow.com/api/v1/keywords/pinterest/trending" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d country=US

GET/api/v1/keywords/pinterest/country-metrics

1 Compute Unit / Request

Retrieve country-level Pinterest audience metrics, keyword volume, and demographic distribution.

Property	Type	Description
keywords •	string	Comma-separated keywords (e.g. "home decor,outfit ideas").
country	string	Target country code (e.g. "US").

Implementation Example

curl -G "https://api.xiaoflow.com/api/v1/keywords/pinterest/country-metrics" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d keywords=home%20decor \
  -d country=US

GET/api/v1/keywords/reddit/suggestions

1 Compute Unit / Request

Get official Reddit Ads keyword suggestions, community discussion topics, and monthly view counts.

Property	Type	Description
keywords •	string	Seed keywords (e.g. "gaming laptop").
country	string	Country code (e.g. "US").

Implementation Example

curl -G "https://api.xiaoflow.com/api/v1/keywords/reddit/suggestions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d keywords=gaming%20laptop \
  -d country=US