MarkUDown
Rank API — MarkUDown 搜索排名追踪 API 文档
POST
/api/rankRank
检查某个域名在 Google 或 Bing 针对某关键词的搜索结果中排第几位。最多扫描 100 条结果,返回准确排名、匹配的 URL、标题和摘要;未找到该域名时返回 null。
| 参数 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| keyword | string | 必填 | — | 要搜索的关键词或短语。 |
| domain | string | 必填 | — | 要在结果中查找的域名(例如 "example.com")。www 和协议会被自动去除。 |
| engine | string | 可选 | "google" | "google" 或 "bing"。 |
| lang | string | 可选 | "en" | 搜索的语言代码。 |
| country | string | 可选 | "us" | 本地化结果的国家代码。 |
| depth | integer | 可选 | 100 | 要扫描的结果数量(最多 100)。 |
| timeout | integer | 可选 | 60 | 请求超时时间(秒)。 |
| callback_url | string | 可选 | null | 任务完成时接收结果(POST)的 webhook URL。 |
请求
{
"keyword": "web scraping api",
"domain": "scrapetechnology.com",
"engine": "google",
"lang": "en",
"country": "us",
"depth": 100
}响应
{
"success": true,
"id": "job_abc123",
"url": "/api/rank/job_abc123"
}
// Poll GET /api/rank/{id} — "data" when completed:
{
"success": true,
"keyword": "web scraping api",
"domain": "scrapetechnology.com",
"engine": "google",
"position": 7,
"url": "https://scrapetechnology.com/markudown",
"title": "MarkUDown — Web Scraping API",
"snippet": "Fast, reliable web scraping...",
"checked_results": 100,
"processing_time_ms": 4210
}