Ranking API
Request
The top Google results for a keyword, plus the AI overview, related searches and the position of your URL.
https://seorch.net/api/ranking/?key=YOUR_KEY&keyword=seo%20check&country=de&url=https://example.com
Parameters
| Parameters | Required | Meaning |
|---|---|---|
key | yes | Your API key, alternatively in the X-API-Key header |
keyword | yes | The keyword |
country | no | Country code, for example de, us, uk. Default: de |
device | no | desktop or mobile |
url | no | Your site: position then shows the first match of this domain |
Response
| Field | Meaning |
|---|---|
position | Rank of your domain or null |
results | Up to 20 results with rank, url, url_resolved, host, title, description |
url_resolved | false if Google only returns a redirect (google.com/goto?url=…) instead of the target page. The domain is still in host and counts for position. The redirect can only be followed after about one minute. |
ai_overview | Text and sources of the AI overview, null if Google shows none |
people_also_ask, related_searches | Further questions and related searches |
{
"api_version": 1,
"keyword": "seo check",
"country": "de",
"device": "desktop",
"url": "https://seorch.de",
"position": 2,
"results": [
{
"rank": 1,
"url": "https://www.seobility.net/de/seocheck/",
"url_resolved": true,
"host": "seobility.net",
"title": "SEO Check | Teste kostenlos Deine Website mit Seobility",
"description": ""
},
{
"rank": 2,
"url": "https://seorch.de/",
"url_resolved": true,
"host": "seorch.de",
"title": "SEO Check - Teste Deine Website kostenlos - SEORCH",
"description": ""
}
],
"ai_overview": {
"text": [
"Ein SEO-Checker ist ein Tool, mit dem Sie eine Website auf wichtige Suchmaschinenfaktoren, technische Fehler u …"
],
"references": [
{
"rank": 1,
"url": "https://www.seobility.net/de/seocheck/",
"host": "seobility.net"
}
],
"url_cited_at": 2
},
"people_also_ask": [],
"related_searches": [
"Google SEO Checker",
"SEO Checker free"
]
}Errors
Errors are returned as JSON with a fixed code. All APIs use missing_key and invalid_key (401), rate_limited (429) and missing or invalid parameters (400). Additionally for this API: upstream_error.
Limits
Each key allows 10 requests per minute and 500 per day. Higher limits are available on request.
Contents