Chargement de XiaoFlow

Préparation du moteur d'intelligence…

XiaoFlowXiaoFlow

Documentation

Accès API

Protocoles de recherche à haut débit et gestion d'API pour les équipes d'ingénierie mondiales.

Quickstart

Sécurisez vos requêtes en incluant un jeton Authorization Bearer dans chaque en-tête.

Point de terminaison de base

https://api.xiaoflow.com/api

Couche d'autorisation

Authorization: Bearer YOUR_TOKEN

MCP

Protocole Officiel d Intelligence MCP XiaoFlow

Intégrez les données Google Ads de XiaoFlow, les volumes de recherche et 48 mois d historique directement dans Claude, ChatGPT, Cursor et vos agents IA.

01 Global Integration Registry

Optimisation des tendances

Utilisez le paramètre `historical=1` uniquement lorsque vous avez besoin du volume de recherche mensuel. La récupération de données historiques sur 48 mois nécessite beaucoup de calculs et peut augmenter les temps de réponse.

Mise en cache intelligente

Notre système met automatiquement en cache les résultats pendant 30 jours. Le fait de demander à nouveau le même mot-clé avec le même emplacement/la même langue dans cette fenêtre ne déduira pas d'unités supplémentaires.

Index du protocole

GET/api/v1/keywords

1 Unité de Calcul / Requête

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

Property	Primitive	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).

Exemple d'implémentation

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 Unité de Calcul / Requête

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

Property	Primitive	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.

Exemple d'implémentation

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 Unité de Calcul / Requête

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

Property	Primitive	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).

Exemple d'implémentation

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 Unité de Calcul / Requête

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

Property	Primitive	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).

Exemple d'implémentation

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 Unité de Calcul / Requête

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

Property	Primitive	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).

Exemple d'implémentation

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 Unité de Calcul / Requête

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

Property	Primitive	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.

Exemple d'implémentation

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 Unité de Calcul / Requête

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

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

Exemple d'implémentation

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 Unité de Calcul / Requête

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

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

Exemple d'implémentation

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 Unité de Calcul / Requête

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

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

Exemple d'implémentation

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

Chargement de XiaoFlow

Préparation du moteur d'intelligence…

Documentation

Accès API

Protocoles de recherche à haut débit et gestion d'API pour les équipes d'ingénierie mondiales.

Quickstart

Sécurisez vos requêtes en incluant un jeton Authorization Bearer dans chaque en-tête.

Point de terminaison de base

https://api.xiaoflow.com/api

Couche d'autorisation

Authorization: Bearer YOUR_TOKEN

MCP

Protocole Officiel d Intelligence MCP XiaoFlow

Intégrez les données Google Ads de XiaoFlow, les volumes de recherche et 48 mois d historique directement dans Claude, ChatGPT, Cursor et vos agents IA.

01 Global Integration Registry

Optimisation des tendances

Mise en cache intelligente

Index du protocole

GET/api/v1/keywords

1 Unité de Calcul / Requête

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

Property	Primitive	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).

Exemple d'implémentation

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 Unité de Calcul / Requête

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

Property	Primitive	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.

Exemple d'implémentation

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 Unité de Calcul / Requête

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

Property	Primitive	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).

Exemple d'implémentation

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 Unité de Calcul / Requête

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

Property	Primitive	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).

Exemple d'implémentation

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 Unité de Calcul / Requête

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

Property	Primitive	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).

Exemple d'implémentation

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 Unité de Calcul / Requête

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

Property	Primitive	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.

Exemple d'implémentation

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 Unité de Calcul / Requête

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

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

Exemple d'implémentation

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 Unité de Calcul / Requête

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

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

Exemple d'implémentation

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 Unité de Calcul / Requête

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

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

Exemple d'implémentation

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