Documentation
API 接口
為全球工程團隊提供的高吞吐量搜尋協定與 API 管理。
快速開始
在每個請求標頭中包含 Authorization 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.
協定索引
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"}'API 介面
訪客每日配額5 Requests
Tier 1 用戶每日配額10 Requests
單元乘數1.0x 核心
格式 嚴格 JSON
Auth Bearer JWT
標準佈署
授權實體可生成唯一的憑證，用於整合至高吞吐量的資料管道。