MarkUDown

Rank API — MarkUDown 搜索排名追踪 API 文档

POST/api/rank

Rank

检查某个域名在 Google 或 Bing 针对某关键词的搜索结果中排第几位。最多扫描 100 条结果,返回准确排名、匹配的 URL、标题和摘要;未找到该域名时返回 null。

参数类型必填默认值描述
keywordstring必填—要搜索的关键词或短语。
domainstring必填—要在结果中查找的域名(例如 "example.com")。www 和协议会被自动去除。
enginestring可选"google""google" 或 "bing"。
langstring可选"en"搜索的语言代码。
countrystring可选"us"本地化结果的国家代码。
depthinteger可选100要扫描的结果数量(最多 100)。
timeoutinteger可选60请求超时时间(秒)。
callback_urlstring可选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
}