正在加载 XiaoFlow

正在启动情报引擎…

XiaoFlowXiaoFlow

文档

API 接口

为全球工程团队提供的高吞吐量搜索协议与 API 管理。

快速开始

在每个请求标头中包含 Authorization Bearer 令牌以确保安全。

基础端点

https://api.xiaoflow.com/api

认证层

Authorization: Bearer YOUR_TOKEN

MCP

XiaoFlow 官方 MCP 搜索智能协议

将 XiaoFlow 企业级 Google Ads 搜索智能、高频商业关键词指标与 48 个月历史趋势无缝注入 Claude、ChatGPT、Cursor 及终端 AI Agent，在您的对话与工作流中即时解锁深度市场洞察。

01 集成设置

趋势分析优化

仅在需要逐月搜索量数据时才使用 `historical=1` 参数。获取 48 个月的历史数据会消耗更多计算单元并可能增加响应时间。

智能缓存机制

系统会自动将查询结果缓存 30 天。在此窗口期内，使用相同的地理位置/语言重新查询相同的关键词不会扣除额外的计算单元。

协议索引

GET/api/v1/keywords

1 计算单元 / 请求

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

属性	类型	描述
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).

实例范例

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 计算单元 / 请求

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

属性	类型	描述
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.

实例范例

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 计算单元 / 请求

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

属性	类型	描述
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).

实例范例

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 计算单元 / 请求

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

属性	类型	描述
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).

实例范例

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 计算单元 / 请求

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

属性	类型	描述
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).

实例范例

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 计算单元 / 请求

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

属性	类型	描述
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.

实例范例

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 计算单元 / 请求

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

属性	类型	描述
country	string	Target country code (e.g. "US", "GB", "CA").
interests	string	Vertical interest category filter.

实例范例

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 计算单元 / 请求

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

属性	类型	描述
keywords •	string	Comma-separated keywords (e.g. "home decor,outfit ideas").
country	string	Target country code (e.g. "US").

实例范例

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 计算单元 / 请求

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

属性	类型	描述
keywords •	string	Seed keywords (e.g. "gaming laptop").
country	string	Country code (e.g. "US").

实例范例

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

正在加载 XiaoFlow

正在启动情报引擎…

文档

API 接口

为全球工程团队提供的高吞吐量搜索协议与 API 管理。

快速开始

在每个请求标头中包含 Authorization Bearer 令牌以确保安全。

基础端点

https://api.xiaoflow.com/api

认证层

Authorization: Bearer YOUR_TOKEN

MCP

XiaoFlow 官方 MCP 搜索智能协议

01 集成设置

趋势分析优化

仅在需要逐月搜索量数据时才使用 `historical=1` 参数。获取 48 个月的历史数据会消耗更多计算单元并可能增加响应时间。

智能缓存机制

系统会自动将查询结果缓存 30 天。在此窗口期内，使用相同的地理位置/语言重新查询相同的关键词不会扣除额外的计算单元。

协议索引

GET/api/v1/keywords

1 计算单元 / 请求

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

属性	类型	描述
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).

实例范例

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 计算单元 / 请求

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

属性	类型	描述
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.

实例范例

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 计算单元 / 请求

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

属性	类型	描述
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).

实例范例

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 计算单元 / 请求

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

属性	类型	描述
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).

实例范例

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 计算单元 / 请求

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

属性	类型	描述
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).

实例范例

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 计算单元 / 请求

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

属性	类型	描述
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.

实例范例

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 计算单元 / 请求

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

属性	类型	描述
country	string	Target country code (e.g. "US", "GB", "CA").
interests	string	Vertical interest category filter.

实例范例

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 计算单元 / 请求

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

属性	类型	描述
keywords •	string	Comma-separated keywords (e.g. "home decor,outfit ideas").
country	string	Target country code (e.g. "US").

实例范例

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 计算单元 / 请求

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

属性	类型	描述
keywords •	string	Seed keywords (e.g. "gaming laptop").
country	string	Country code (e.g. "US").

实例范例

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