MarkUDown

Rank API — MarkUDown SERP rank tracking API docs

POST/api/rank

Rank

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.

ParameterTypeRequiredDefaultDescription
keywordstringrequired—Keyword or phrase to search for.
domainstringrequired—Domain to look for in the results (e.g. "example.com"). www and the protocol are stripped automatically.
enginestringoptional"google""google" or "bing".
langstringoptional"en"Language code for the search.
countrystringoptional"us"Country code for localized results.
depthintegeroptional100Number of results to scan (max 100).
timeoutintegeroptional60Request timeout in seconds.
callback_urlstringoptionalnullWebhook 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
}