apyhub
Back
▣ RETRIEVAL KIT

SERP Rank Checker API

Hosted on ApyHub

What it does

The Rank Tracker API shows where pages rank on Google for any keyword. Send a keyword, and optionally a location (country code), language, and size (number of results). You get back a JSON data array with each result's rank, url, title, domain, breadcrumb, and description. Each result is labeled by type, so organic and sponsored listings stay separate.

To track keyword rankings over time, call the rank tracker API on a schedule, daily or weekly, and store the positions. Find your domain in the results to get your position, and see which competitors rank above you. Change location and language to check the same keyword in other markets.

Teams use it as a keyword ranking API and SEO rank API behind rank tracking dashboards, client reports, and alerts when a page drops. It returns the top results for a query; for larger result sets and SERP features, use the SE Ranking SERP API.

To understand why rankings move, pair it with the Backlinks API and the Keyword Research API, and read the pages that outrank you with the Extract Text from Webpage API. AI agents can also call it through ApyHub MCP.

POST
Get SERP rankings for a keyword
https://api.eu.apyhub.com/apyhub/serp-rankings-for-keyword

QUICKSTART

GUIDE

Quickstart

Search SERP rankings for a keyword with the required keyword plus the default locale settings.

curl -X POST "https://api.eu.apyhub.com/apyhub/serp-rankings-for-keyword" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "FastAPI python"
  }'

What you'll get back

Returns a JSON object with a data array field.data is an array of result objects, each with fields like url, rank, type, title, domain, breadcrumb, and description.

{
  "data":  [
      {
        "url": "https://fastapi.tiangolo.com",
        "rank": 1,
        "type": "organic",
        "title": "FastAPI - Modern Python Web Framework",
        "domain": "fastapi.tiangolo.com",
        "breadcrumb": "fastapi.tiangolo.com",
        "description": "FastAPI framework, high performance, easy to learn, fast to code."
      }
    ]
}
TRY ITLIVE · 250 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Search keyword or phrase.
Number of results to return.
ISO 639-1 language code (e.g. en, de, fr, ja, zh-cn).
ISO 3166-1 alpha-2 country code (e.g. us, gb, de, in, au).

About this endpoint

What it does

Retrieves SERP rankings for a keyword and returns the matching results in the response. You provide the keyword to search for, and can optionally set the number of results, language, and location.

Request Body

ParameterTypeDescription
keywordStringSearch keyword or phrase.
sizeIntegerNumber of results to return. Default: 10. Minimum: 1.
languageStringISO 639-1 language code (e.g. en, de, fr, ja, zh-cn). Default: en.
locationStringISO 3166-1 alpha-2 country code (e.g. us, gb, de, in, au). Default: us.

Response

Returns a JSON object with a data array field. data contains SERP result objects directly, each with url, rank, type, title, domain, breadcrumb, and description fields.

ParameterTypeDescription
dataObject ArrayArray of result objects, ranked across all result types (organic and sponsored).
data[].urlStringURL of the ranked result (URI string).
data[].rankIntegerPosition of the result in the combined ranked result set.
data[].typeStringResult type (e.g. organic or inorganic).
data[].titleStringTitle of the ranked page.
data[].domainStringDomain of the ranked page.
data[].breadcrumbStringBreadcrumb or URL path shown for the result.
data[].descriptionStringSnippet or description text for the result.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.