Caricamento di XiaoFlow

Preparazione del motore di intelligence…

XiaoFlowXiaoFlow

Documentation

Accesso API

Protocolli di ricerca ad alto rendimento e gestione API per i team di ingegneria globali.

Quickstart

Proteggi le tue richieste includendo un token Authorization Bearer in ogni intestazione.

Endpoint di base

https://api.xiaoflow.com/api

Livello di autorizzazione

Authorization: Bearer YOUR_TOKEN

MCP

Protocollo Ufficiale di Intelligence MCP XiaoFlow

Integra i dati Google Ads di XiaoFlow, le metriche sulle parole chiave e 48 mesi di storico direttamente in Claude, ChatGPT, Cursor e nei tuoi agenti IA.

01 Global Integration Registry

Ottimizzazione dei trend

Usa il parametro `historical=1` solo quando hai bisogno del volume di ricerca mensile. Il recupero di dati storici di 48 mesi richiede molte risorse di calcolo e può prolungare i tempi di risposta.

Caching intelligente

Il nostro sistema memorizza automaticamente i risultati nella cache per 30 giorni. Richiedere nuovamente la stessa parola chiave con la stessa posizione/lingua entro questo intervallo di tempo non dedurrà ulteriori unità.

Indice del protocollo

GET/api/v1/keywords

1 Unità di calcolo / Richiesta

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

Esempio di implementazione

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à di calcolo / Richiesta

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.

Esempio di implementazione

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à di calcolo / Richiesta

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

Esempio di implementazione

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à di calcolo / Richiesta

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

Esempio di implementazione

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à di calcolo / Richiesta

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

Esempio di implementazione

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à di calcolo / Richiesta

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.

Esempio di implementazione

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à di calcolo / Richiesta

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.

Esempio di implementazione

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à di calcolo / Richiesta

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").

Esempio di implementazione

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à di calcolo / Richiesta

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").

Esempio di implementazione

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

Caricamento di XiaoFlow

Preparazione del motore di intelligence…

Documentation

Accesso API

Protocolli di ricerca ad alto rendimento e gestione API per i team di ingegneria globali.

Quickstart

Proteggi le tue richieste includendo un token Authorization Bearer in ogni intestazione.

Endpoint di base

https://api.xiaoflow.com/api

Livello di autorizzazione

Authorization: Bearer YOUR_TOKEN

MCP

Protocollo Ufficiale di Intelligence MCP XiaoFlow

Integra i dati Google Ads di XiaoFlow, le metriche sulle parole chiave e 48 mesi di storico direttamente in Claude, ChatGPT, Cursor e nei tuoi agenti IA.

01 Global Integration Registry

Ottimizzazione dei trend

Usa il parametro `historical=1` solo quando hai bisogno del volume di ricerca mensile. Il recupero di dati storici di 48 mesi richiede molte risorse di calcolo e può prolungare i tempi di risposta.

Caching intelligente

Indice del protocollo

GET/api/v1/keywords

1 Unità di calcolo / Richiesta

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

Esempio di implementazione

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à di calcolo / Richiesta

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.

Esempio di implementazione

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à di calcolo / Richiesta

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

Esempio di implementazione

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à di calcolo / Richiesta

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

Esempio di implementazione

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à di calcolo / Richiesta

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

Esempio di implementazione

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à di calcolo / Richiesta

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.

Esempio di implementazione

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à di calcolo / Richiesta

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.

Esempio di implementazione

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à di calcolo / Richiesta

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").

Esempio di implementazione

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à di calcolo / Richiesta

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").

Esempio di implementazione

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