Alle Tools

  1. SEORCH
  2. SEO API
  3. Ranking API

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

ParameterPflichtBedeutung
keyjaDein API Key, alternativ im Header X-API-Key
keywordjaDas Keyword
countryneinLand als Kürzel, zum Beispiel de, us, uk. Standard: de
languageneinSprache der Suche, zum Beispiel de, en, fr. Standard: passend zum Land
deviceneindesktop (Standard) oder mobile
locationneinOrt der Suche als Google-Ortsname: Ort, Bundesland, Land auf Englisch, zum Beispiel Karlsruhe,Baden-Wurttemberg,Germany (höchstens 63 Zeichen)
uuleneinAlternativ zu location: der Ort als fertig kodiertes uule
resultsneinAnzahl der Ergebnisse: 10 (Standard), 20, 30 … 100
urlneinDeine Seite: position nennt dann den ersten Treffer dieser Domain

Antwort

FeldBedeutung
positionPlatz deiner Domain oder null
resultsDie organischen Ergebnisse, bis zu results Stück, mit rank, url, url_resolved, host, title, description
url_resolvedfalse, 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_resultsDie lokalen Ergebnisse aus der Kartenbox mit rank, title, type, address, rating, reviews und description. Leer, wenn Google keine zeigt (mobil immer leer)
language, location, uuleDie verwendeten Angaben, sonst null
ai_overviewText und Quellen der KI-Übersicht, null wenn Google keine zeigt
people_also_ask, related_searchesWeitere Fragen und verwandte Suchen
Beispielantwort
{
  "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.