Loading XiaoFlow
Preparing intelligence engine...
Preparing intelligence engine...
Access our data through the API.
Secure your requests by including an Authorization bearer token in every header.
https://www.xiaoflow.com/api/apiThe Model Context Protocol (MCP) enables AI agents to use XiaoFlow tools directly. Connect your intelligence layer to our search data.
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.
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.
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). |
curl -G "https://www.xiaoflow.com/api/api/keywords" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d keyword=wedding%20rings \ -d location_id=US \ -d historical=1 \ -d date_range=24
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. |
curl -X POST "https://www.xiaoflow.com/api/api/keywords/ideas" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"keywords": ["wedding rings"], "location_id": "us", "language_id": "en", "historical": true}'High-throughput bulk metrics retrieval for up to 1,000 keywords in a single call.
| 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). |
curl -X POST "https://www.xiaoflow.com/api/api/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}'Retrieve a list of supported countries and their corresponding location IDs.
| Property | Type | Description |
|---|
curl -G "https://www.xiaoflow.com/api/api/keywords/countries" \ -H "Authorization: Bearer YOUR_TOKEN"
Retrieve a list of supported languages and their corresponding IDs.
| Property | Type | Description |
|---|
curl -G "https://www.xiaoflow.com/api/api/keywords/languages" \ -H "Authorization: Bearer YOUR_TOKEN"
Get comprehensive Etsy shop intelligence, including active listings, sales history, and revenue estimates.
| Property | Type | Description |
|---|---|---|
| query • | string | Shop ID or Shop Name (e.g. "SimpleLivingShop"). |
| refresh | boolean | Force sync with live Etsy data (costs 1 unit). |
curl -G "https://www.xiaoflow.com/api/api/etsy/shop" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d query=SimpleLivingShop
Retrieve deep performance metrics for a specific Etsy listing, including sales trends and engagement data.
| Property | Type | Description |
|---|---|---|
| query • | string | Listing ID or URL (e.g. "123456789"). |
| refresh | boolean | Force sync with live Etsy data (costs 1 unit). |
curl -G "https://www.xiaoflow.com/api/api/etsy/listing" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d query=123456789
Search for Etsy buyer profiles by username or user ID to analyze their review history and purchasing behavior.
| Property | Type | Description |
|---|---|---|
| query • | string | Buyer username or user ID. |
curl -G "https://www.xiaoflow.com/api/api/etsy/buyer-search" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d query=craftybuyer
You can generate unique keys for API integration.