开发文档
API 接口
通过 API 直接获取搜索数据。
快速开始
通过在每个请求头中包含 Bearer 令牌来确保安全。
https://api.xiaoflow.com/apiAuthorization: Bearer YOUR_TOKEN
AI Integration
AI-Powered Search
The Model Context Protocol (MCP) enables AI agents to use XiaoFlow tools directly. Connect your intelligence layer to our search data.
API 接口列表
GET/api/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). |
curl -G "https://api.xiaoflow.com/api/keywords" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d keyword=wedding%20rings \ -d location_id=US \ -d language_id=en
GET/api/websites
1 计算单元 / 请求
Extract domain-level keyword dominance and organic ranking data for any website or specific URL.
| 属性 | 类型 | 描述 |
|---|---|---|
| site | string | Domain name (e.g. "nike.com"). |
| url | string | Specific URL for deep analysis. |
| location_id | string | Location ID or ISO code. |
| language_id | string | Language ID or code. |
curl -G "https://api.xiaoflow.com/api/websites" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d site=apple.com \ -d location_id=US
POST/api/keywords/bulk
1 计算单元 / 请求
High-throughput bulk metrics retrieval for up to 1,000 keywords in a single call.
| 属性 | 类型 | 描述 |
|---|---|---|
| keywords • | array | List of keywords to analyze. |
| location_id | string | Location ID or ISO code. |
| language_id | string | Language ID or code. |
curl -X POST "https://api.xiaoflow.com/api/keywords/bulk" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"keywords": ["wedding rings", "diamond rings"], "location_id": "US"}'POST/api/keywords/bulk/trends
1 计算单元 / 请求
Deep data bulk retrieval. Returns core metrics PLUS 12-month historical history for all keywords in the batch.
| 属性 | 类型 | 描述 |
|---|---|---|
| keywords • | array | List of keywords to analyze. |
| location_id | string | Location ID or ISO code. |
| language_id | string | Language ID or code. |
curl -X POST "https://api.xiaoflow.com/api/keywords/bulk/trends" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"keywords": ["wedding rings", "engagement rings"], "location_id": "US"}'用量限制
游客每日限制5 Requests
正式用户每日限制10 Requests
用量倍率标准倍率
格式 JSON 格式
Auth Bearer JWT
可用
您可以生成唯一的 API 密钥。