apyhub
Back
▣ SEO

SERP Rank Checker API

Hosted on ApyHub

What it does

The SERP Rank Checker API shows where pages rank on Google for any keyword. Send a keyword, and optionally the country, language, and number of results, and get back each result's position, URL, title, domain, breadcrumb, and snippet as JSON. Results include both organic and sponsored listings, marked by type.

Use it to track your own rankings over time, see which competitors outrank you, check how a keyword performs in different markets, or power rank tracking dashboards and SEO tools. For the top 100 results, use the SE Ranking SERP API, and see why rankings change with the Backlinks API. To read and analyze the pages that rank, use the Extract Text from Webpage and Keyword Extraction APIs.

You can start on ApyHub's free tier with no card required.

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

ParameterTypeMandatoryDescription
keywordStringYesSearch keyword or phrase.
sizeIntegerNoNumber of results to return. Default: 10. Minimum: 1.
languageStringNoISO 639-1 language code (e.g. en, de, fr, ja, zh-cn). Default: en.
locationStringNoISO 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.

ParameterTypeMandatoryDescription
dataObject ArrayNoArray of result objects, ranked across all result types (organic and sponsored).
data[].urlStringNoURL of the ranked result (URI string).
data[].rankIntegerNoPosition of the result in the combined ranked result set.
data[].typeStringNoResult type (e.g. organic or inorganic).
data[].titleStringNoTitle of the ranked page.
data[].domainStringNoDomain of the ranked page.
data[].breadcrumbStringNoBreadcrumb or URL path shown for the result.
data[].descriptionStringNoSnippet or description text for the result.

Body

Name
Type
Description
bodyREQUIRED
object
—
▣ 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.

Similar APIs

Closest matches in the catalog based on this service.

CALLGet SERP Results APISE Ranking SEO & AI Search APICALLEvaluate SEO Health APIWebsite IntelligenceCALLAdvanced Domain Analysis APISE Ranking SEO & AI Search APICALLSearch Domains by Keyword APIDosvak LLC