sites

Check Rankings Ep

Run DataForSEO ranking check for all tracked keywords.

Small sets (<= RANK_CHECK_INLINE_MAX) run inline and return the checked rows. Larger sets start in the background and return status="started": ~3.5 s of live SERP per keyword would outlast the MCP client's timeout, and a timed-out caller retried and paid twice (2026-09-26). While a check is running, a second call returns status="running" instead of starting another.

post/sites/{site_id}/tracked-keywords/check

Request

  • Base URL: https://api.xeorank.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.xeorank.com/sites/{site_id}/tracked-keywords/check
  • Auth: API key in header X-Agent-Key

Path parameters

site_idstring required

Query parameters

emailstring nullable
due_onlyboolean

Response

Successful Response

checkedinteger required
statusstring
run_idstring nullable
keyword_countinteger nullable
estimated_secondsinteger nullable
next_stepstring nullable
not_rankinginteger
failedinteger
errorsstring[]
locationstring nullable
notestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.