---
title: "Keyword Rank Check (x402)"
method: POST
path: "/x402/v2/keyword-rank-check"
tags: ["x402"]
---

# Keyword Rank Check (x402)

`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

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.

## Request body

- object
  - `depth` integer: Number of results to scan (Serper "num" parameter). Defaults to 10, max 100.
  - `domain` string, required: Domain to check ranking for (e.g. stripe.com). Aliases: url, site.
  - `country` string: 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".
  - `keyword` string, required: Search term to check ranking for. Aliases: query, search, term.
  - `language` string: 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 `200`

Success

- object
  - `page` integer, nullable
  - `found` boolean
  - `position` integer, nullable
  - `competitors_above` unknown[]
    - unknown

## Other responses

- `402`: Payment required (x402 — pay with USDC on Base)

---

[API](https://skmtc.dev/strale/apis/strale-api-2.md) · [All operations](https://skmtc.dev/strale/apis/strale-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/strale/apis/strale-api-2/revisions/a5293878cfc6?raw)