x402

Keyword Rank Check (x402)

Check where a domain ranks in Google search results for a keyword. Returns the position, page, matching result, and the competitors ranking above it within the scanned depth.

post/x402/v2/keyword-rank-check

Request

Base URL: https://api.strale.io
URL: https://api.strale.io/x402/v2/keyword-rank-check
Auth: none required

Request body

depthinteger

Number of results to scan (Serper "num" parameter). Defaults to 10, max 100.

domainstring required

Domain to check ranking for (e.g. stripe.com). Aliases: url, site.

countrystring

Market to check the ranking in, as an ISO 3166-1 alpha-2 code (SE), alpha-3 code (SWE), numeric code (752), or exact country name (Sweden). "UK" is accepted as an alias for GB. Unrecognised values are rejected before the search runs rather than silently ignored. Sent to Google as the gl parameter. Defaults to "us".

keywordstring required

Search term to check ranking for. Aliases: query, search, term.

languagestring

Language for results, as an ISO 639-1 code ("en"), optionally with a region ("pt-BR"). Validated for shape and rejected before the search runs if malformed, rather than silently ignored. Sent to Google as the hl parameter. Defaults to "en".

Response

Success

pageinteger nullable

foundboolean

positioninteger nullable

Example response

{
  "url": "https://en.wikipedia.org/wiki/Main_Page",
  "page": 1,
  "found": true,
  "title": "Wikipedia, the free encyclopedia",
  "domain": "wikipedia.org",
  "country": "us",
  "keyword": "wikipedia",
  "snippet": "Wikipedia is a free online encyclopedia, created and edited by volunteers around the world.",
  "language": "en",
  "position": 1,
  "results_scanned": 10,
  "competitors_above": [],
  "scan_depth_requested": 10
}

Changes

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