apyhub
MARKETING · SEO

SERP Rank Checker API

What it does

SERP Rankings gives you the top search results for a keyword, filtered by language and location. Send a keyword phrase and optional size, language, and location values, and get back ranked results with the URL, rank, type, title, domain, breadcrumb, and description for each listing.

Use it when you need to compare search visibility across markets, monitor how a query performs in a specific country, or pull competitor results into an SEO workflow. The response is structured for direct use in reporting, rank tracking, and analysis tools.

SERP Rankings is built for keyword research and search result inspection, not general web search. The size field lets you control how many results you receive, while language and location help narrow the SERP to the audience you care about. Each result includes the ranking position and the page metadata needed to identify and group listings.

If you are building an SEO dashboard, tracking a brand term, or checking how a tutorial query ranks in different regions, this endpoint gives you the SERP data you need in one response.

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

QUICKSTART

GUIDE

Quickstart

Search SERP rankings for a keyword by sending the required keyword in a JSON body.

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

What you'll get back

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

{
  "data": {
    "results": [
      {
        "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.

About this endpoint

What it does

Retrieves SERP ranking results for a keyword and returns them in a JSON object. You provide a search keyword, with optional size, language, and location inputs, and the response contains a data.results array of result objects.

Request Body

ParameterTypeMandatoryDescription
keywordStringYesSearch keyword or phrase.
sizeIntegerNoNumber of results to return. Default: 10. Minimum: 1.
languageStringNoISO 639-1 language code (for example: en, de, fr, ja, zh-cn). Default: en.
locationStringNoISO 3166-1 alpha-2 country code (for example: us, gb, de, in, au). Default: us.

Response

Returns a JSON object with a data object field. data contains a results array of result objects; each result includes url, rank, type, title, domain, breadcrumb, and description fields. Success returns HTTP 200.

ParameterTypeMandatoryDescription
dataObjectNoResponse wrapper containing the results array.
data.resultsObject ArrayNoList of SERP result objects.
data.results[].urlStringNoResult URL. Format: URI.
data.results[].rankIntegerNoResult position in the SERP.
data.results[].typeStringNoResult type.
data.results[].titleStringNoResult title.
data.results[].domainStringNoResult domain.
data.results[].breadcrumbStringNoResult breadcrumb text.
data.results[].descriptionStringNoResult description snippet.

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.