Ranking API
Aufruf
Die Top-Ergebnisse von Google für ein Keyword, auch für einen bestimmten Ort und mobil, dazu lokale Ergebnisse, KI-Übersicht, verwandte Suchen und die Position deiner URL.
https://seorch.de/api/ranking/?key=DEIN_KEY&keyword=pizza&country=de&location=Karlsruhe,Baden-Wurttemberg,Germany&url=https://www.lieferando.de
Parameter
| Parameter | Pflicht | Bedeutung |
|---|---|---|
key | ja | Dein API Key, alternativ im Header X-API-Key |
keyword | ja | Das Keyword |
country | nein | Land als Kürzel, zum Beispiel de, us, uk. Standard: de |
language | nein | Sprache der Suche, zum Beispiel de, en, fr. Standard: passend zum Land |
device | nein | desktop (Standard) oder mobile |
location | nein | Ort der Suche als Google-Ortsname: Ort, Bundesland, Land auf Englisch, zum Beispiel Karlsruhe,Baden-Wurttemberg,Germany (höchstens 63 Zeichen) |
uule | nein | Alternativ zu location: der Ort als fertig kodiertes uule |
results | nein | Anzahl der Ergebnisse: 10 (Standard), 20, 30 … 100 |
url | nein | Deine Seite: position nennt dann den ersten Treffer dieser Domain |
Antwort
| Feld | Bedeutung |
|---|---|
position | Platz deiner Domain oder null |
results | Die organischen Ergebnisse, bis zu results Stück, mit rank, url, url_resolved, host, title, description |
url_resolved | false, wenn Google statt der Zielseite nur eine Weiterleitung (google.com/goto?url=…) liefert. Die Domain steht dann trotzdem in host und zählt für position. Die Weiterleitung lässt sich erst nach etwa einer Minute aufrufen. |
local_results | Die lokalen Ergebnisse aus der Kartenbox mit rank, title, type, address, rating, reviews und description. Leer, wenn Google keine zeigt (mobil immer leer) |
language, location, uule | Die verwendeten Angaben, sonst null |
ai_overview | Text und Quellen der KI-Übersicht, null wenn Google keine zeigt |
people_also_ask, related_searches | Weitere Fragen und verwandte Suchen |
{
"api_version": 1,
"keyword": "pizza",
"country": "de",
"language": null,
"device": "desktop",
"location": "Karlsruhe,Baden-Wurttemberg,Germany",
"uule": null,
"url": "https://www.lieferando.de",
"position": 6,
"results": [
{
"rank": 1,
"url": "https://www.google.com/url?q=CAESswEBxCJF11eLcyK0bCBjAUN3_qUKa4y4AcRe-PBUNXnu",
"url_resolved": false,
"host": "ubereats.com",
"title": "Pizza-Lieferung in Stuttgart 2023 | DIE ZEHN BESTEN ... - Uber Eats",
"description": "Heißhunger auf Pizza? Lass es dir schnell und bequem über dein Uber Konto liefern. Bestelle online von den besten Restaurants der Kategorie Pizza in ..."
},
{
"rank": 2,
"url": "https://www.google.com/url?q=CAESXwHEIkXXKQF6SJ9iQa0tlEMy4tP3OsIEt1xB9kTuBZ5-",
"url_resolved": false,
"host": "pizzeria.de",
"title": "Pizza in Philippsburg bestellen beim Lieferservice",
"description": "ganztägig geschlossen. ab: 20,00 €. Barzahlung. Pizza, Pasta, Salate, Schnitzel, Mexikanisch, Kepab, Indisch, Chinesisch, Big-Burger, ..."
},
{
"rank": 3,
"url": "https://mannheim.online-pizza.de/",
"url_resolved": true,
"host": "mannheim.online-pizza.de",
"title": "Pizza Mannheim | Lieferservice Mannheim | Pizzataxi Mannheim ...",
"description": "Hunger auf knusprige Pizza, knackige Salate, saftige Burger oder feinstes Sushi? Online-Pizza.de bietet italienische, asiatische und internationale ..."
},
{
"rank": 4,
"url": "https://www.google.com/url?q=CAESXgHEIkXXkIAkKN1IHQ8GKk0RQbxPEiFNsAb99gNUJSpC",
"url_resolved": false,
"host": "pizzeria.de",
"title": "Pizza in Ludwigsburg online bestellen | pizzeria.de",
"description": "Hier Pizza in Ludwigsburg online beim Lieferservice bestellen. Pizza in Ludwigsburg schnell und sicher bestellen bei pizzeria.de."
},
{
"rank": 5,
"url": "https://www.google.com/url?q=CAEScgHEIkXXzKV-0CA7gs2jCYgU8viwcFeSGjsPb3dhMY1k",
"url_resolved": false,
"host": "dasoertliche.de",
"title": "Pizza in Darmstadt ⇒ in Das Örtliche",
"description": "Gesamt 31 Adressen zu Pizza in Darmstadt mit Telefonnummer ☎, Öffnungszeiten ✓ und Bewertung ☆ Direkt Angebot vergleichen und Termin ..."
},
{
"rank": 6,
"url": "https://www.lieferando.de/lieferdienst/stuttgart-ost/pizza",
"url_resolved": true,
"host": "lieferando.de",
"title": "Pizza-Lieferung & Takeaway in Stuttgart Ost | Bestelle bei Lieferando",
"description": "Bestelle Pizza von Takeaways und Restaurants in deiner Nähe in Stuttgart Ost. Wähle aus einer Vielzahl von Restaurants – geliefert direkt bis vor deine ..."
},
{
"rank": 7,
"url": "https://www.google.com/url?q=CAESYQHEIkXXQpOVuKZOmsAhAHP4wPoI95OcNHnP9Bs_1Ort",
"url_resolved": false,
"host": "pizzeria.de",
"title": "Pizza in Kaiserslautern online bestellen | pizzeria.de",
"description": "New Yorks Pizza · 67655 Kaiserslautern · Pariser Str. 51 · Blue Pizza · 67663 Kaiserslautern · Kurt-Schumacher-Str.12 · Joeys Pizza · 67655 Kaiserslautern."
},
{
"rank": 8,
"url": "https://www.google.com/url?q=CAEShwEBxCJF16YoVAMjnM7EvtoeY6v7uRPQtYZbv7WGc_9P",
"url_resolved": false,
"host": "tripadvisor.de",
"title": "Die Besten Pizzas in Essen - Tripadvisor",
"description": "Beste Pizza Restaurants in Essen, Niedersachsen: Tripadvisor Bewertungen von Restaurants in Essen finden und die Suche nach Küche, Preis, Lage und mehr ..."
},
{
"rank": 9,
"url": "https://www.google.com/url?q=CAEShAEBxCJF1znlUgCcBCsu8dfKNH5Ysyr39-r2S-ACzppA",
"url_resolved": false,
"host": "dasoertliche.de",
"title": "Pizza-Lieferdienst in Günzburg - Das Örtliche",
"description": "Pizza-Lieferdienst in Günzburg ; Joginder Singh Pizzaservice. Essenbringdienste. Augsburger Str. 18 89312 Günzburg ; Pizza Express Venezia."
}
],
"local_results": [
{
"rank": 1,
"title": "60 seconds to napoli Karlsruhe",
"type": "Pizzeria",
"address": "Karlstraße 11",
"rating": 4.6,
"reviews": 8857,
"description": null
},
{
"rank": 2,
"title": "Pizza & Gusto",
"type": "Pizza",
"address": "Amalienstraße 14A",
"rating": 4.5,
"reviews": 885,
"description": null
}
],
"ai_overview": {
"text": [
"Pizza ist ein italienisches Fladenbrot, das mit Tomatensauce und Käse belegt und im Ofen gebacken wird."
],
"references": [
{
"rank": 1,
"url": "https://de.wikipedia.org/wiki/Pizza",
"host": "de.wikipedia.org"
}
],
"url_cited_at": null
},
"people_also_ask": [
{
"question": "Welche Pizza ist die beliebteste in Deutschland?",
"answer": null,
"url": null
}
],
"related_searches": [
"Pizza in der Nähe",
"Pizza bestellen",
"Pizza Stuttgart"
]
}
Fehler
Fehler kommen als JSON mit festem Code. Für alle APIs gelten missing_key und invalid_key (401), rate_limited (429) und fehlende oder ungültige Parameter (400). Außerdem bei dieser API: invalid_language, invalid_location, invalid_uule, invalid_results, upstream_error.
Limits
Pro Key gelten 10 Anfragen pro Minute und 500 pro Tag. Höhere Limits sind auf Anfrage möglich.
Für die Ranking API kann zusätzlich ein eigenes Tages- und Monatslimit vereinbart sein. Ist es erreicht, kommt rate_limited (429) mit limit = ranking_per_day bzw. ranking_per_month und retry_after in Sekunden. Den Stand zeigen die Header X-RateLimit-Remaining-Api-Day und X-RateLimit-Remaining-Api-Month.