apyhub
▣ SEO

SERP Rank Checker API

Hosted on ApyHub

What it does

SERP Rankings lets you look up search engine results for a keyword and see the top matching pages returned for a specific language and location.

Send a keyword, and optionally set size, language, and location. The response returns an array of search results, with each result including its rank, title, url, domain, breadcrumb, type, and description. That gives you the key elements you need to inspect ranking pages, compare competitors, or feed keyword research workflows.

Use SERP Rankings when you need to monitor how a query performs in a target market, validate SEO assumptions, or build internal tools that track search visibility over time. Because the output includes ranked results rather than a simple yes/no answer, it works well for dashboards, audits, and analysis pipelines that need concrete SERP data.

POST
Get SERP rankings for a keyword
http://localhost:8080/apyhub/serp-rankings-for-keyword
QUICKSTARTGUIDE

Quickstart

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

curl -X POST "http://localhost:8080/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*
Number of results to return.
Search keyword or phrase.
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.

Product
CatalogPricingBecome a providerStatus (opens in new tab)
Company
AboutBlogCareers (opens in new tab)Contact
Legal
Terms of ServicePrivacy PolicyProvider terms
© 2026 APYHUB · BUILT FOR DEVELOPERS