MarkUDown
Rank API — MarkUDown SERP rank tracking API docs
POST
/api/rankRank
Check the position at which a domain appears in Google or Bing search results for a given keyword. Scans up to 100 results and returns the exact position, matching URL, title and snippet — or null when the domain is not found.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| keyword | string | required | — | Keyword or phrase to search for. |
| domain | string | required | — | Domain to look for in the results (e.g. "example.com"). www and the protocol are stripped automatically. |
| engine | string | optional | "google" | "google" or "bing". |
| lang | string | optional | "en" | Language code for the search. |
| country | string | optional | "us" | Country code for localized results. |
| depth | integer | optional | 100 | Number of results to scan (max 100). |
| timeout | integer | optional | 60 | Request timeout in seconds. |
| callback_url | string | optional | null | Webhook URL to POST the result to when the job completes. |
Request
{
"keyword": "web scraping api",
"domain": "scrapetechnology.com",
"engine": "google",
"lang": "en",
"country": "us",
"depth": 100
}Response
{
"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
}