seo/
google-organic-serp

Eine Live-Ergebnisseite von Google zu einer Abfrage und einem Markt abrufen – mit Ziel-URLs, Titeln, Rangpositionen, Elementtypen und Ergebnisdetails in normalisierten Datensätzen.

Google Organic SERP API

Live-SERP-Momentaufnahme
Geräteauswahl
Gemischte Ergebniselemente
0,1 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Google Organic SERP

Organische Google-Suchergebnisseiten kombinieren gerankte Links mit weiteren sichtbaren Elementen wie Featured Snippets, Fragen, lokalen Ergebnissen und Videos. Ihre Ziele, Positionen, Elementtypen und Darstellungsdetails eignen sich für Ranking-Momentaufnahmen, Layoutanalysen und den Vergleich von Geräten oder Märkten.

Funktionen der Google Organic SERP API

  • Markt-Momentaufnahme zu einer AbfrageLöst eine Suchanfrage mit ausdrücklichen Einstellungen für Markt, Sprache und Desktop oder Mobilgerät auf und liefert eine vergleichbare Ergebnisseite als Momentaufnahme.
  • Rang- und ZielfelderLiefert die verfügbaren Ziel-URLs, Anzeigetitel, Gruppenpositionen, absoluten Positionen und Seitenzahlen der Suchergebnisse in normalisierten Feldern.
  • Abdeckung gemischter SERP-ElementeBehält organische Links und weitere zurückgegebene Ergebnistypen bei; extra.type gibt für jeden Datensatz an, welche Art von Element er darstellt.
  • Vollständiger ElementkontextBewahrt das vollständige elementspezifische Objekt in extra auf, sodass Domains, Snippets, Breadcrumbs, Bilder und Attribute von Rich Results verfügbar bleiben, wenn sie vorhanden sind.

Parameter der Google Organic SERP API

ParameterErforderlichBeschreibung
queryErforderlichErforderliche, nicht leere Suchanfrage. Eine Aufgabe akzeptiert eine Anfrage.
location_codeOptionalPositiver numerischer Marktcode. Der Playground verwendet standardmäßig 2840 für die USA.
location_nameOptionalOptionaler Name des Suchmarkts als Alternative zu location_code. Wenn er ausgefüllt ist, hat er Vorrang vor location_code.
language_codeOptionalSprachcode der Suche mit 2 bis 10 Zeichen. Der Playground verwendet standardmäßig en.
languageOptionalOptionaler Name der Suchsprache als Alternative zu language_code. Wenn er ausgefüllt ist, hat er Vorrang vor language_code.
deviceOptionalGerätekontext der Suche: desktop oder mobile.
results_limitOptionalGewünschte Ranking-Tiefe von 1 bis 700. Sie ist eine Obergrenze und garantiert nicht die gleiche Anzahl abgeflachter Elemente.

So verwenden Sie die Google Organic SERP API

Senden Sie eine Abfrage mit codebasierten Markteinstellungen und begrenzter Tiefe und lesen Sie anschließend jedes normalisierte SERP-Element aus der abgeschlossenen asynchronen Aufgabe.

  1. Wählen Sie eine nicht leere Abfrage query, einen location_code, einen language_code, ein device und ein results_limit von 1 bis 200.
  2. Senden Sie die Nutzdaten per POST an /v1/seo/google-organic-serp und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler zurückgibt.
  4. Lesen Sie data.results.items und fordern Sie dann den zurückgegebenen next_cursor an, solange has_more den Wert true behält.
curl -X POST "https://api.socq.ai/v1/seo/google-organic-serp" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"keyword research","location_code":2840,"language_code":"en","device":"desktop","results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der Google Organic SERP API

  • Aktuelle Rank-Momentaufnahmen: Nutzen Sie Ziel-URLs zusammen mit rank.group, rank.absolute, rank.page und collected_at, um festzuhalten, wo zurückgegebene Seiten bei einer definierten Abfrage erscheinen.
  • Vergleich von Geräten und Märkten: Senden Sie passende Abfragen mit kontrollierten Werten für device, location_code und language_code, um Ergebnisziele und Positionen über verschiedene Kontexte hinweg zu vergleichen.
  • Analyse des SERP-Layouts: Prüfen Sie extra.type und die elementspezifischen Felder, um gerankte Links von Fragen, Snippets, lokalen Ergebnissen, Videos und weiteren zurückgegebenen Seitenelementen zu unterscheiden.

Profi-Tipps zur Google Organic SERP API

  • Halten Sie query, location_code und language_code beim Vergleich von Desktop und Mobilgerät unverändert, damit das Gerät die einzige geplante Variable bleibt.
  • Verwenden Sie ein results_limit von höchstens 200, auch wenn die Validierung der Route größere Werte akzeptiert, denn die Tiefe der erweiterten Live-Ergebnisse ist auf 200 begrenzt.
  • Verzweigen Sie nach extra.type, bevor Sie elementspezifische Schlüssel lesen, und rechnen Sie damit, dass url und rank-Werte bei Elementen fehlen, die sie nicht bereitstellen.
  • Behandeln Sie rank.page als Nummer der Suchergebnisseite; verwenden Sie next_cursor getrennt davon, um die gespeicherten SocQ-Ergebnisdatensätze zu paginieren.
  • Speichern Sie extra als flexibles Objekt, weil die verfügbaren Schlüssel je nach SERP-Elementtyp variieren und sich weiterentwickeln können.

Ergänzend zur Google Organic SERP API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher SEO-Daten benötigen.

  • Keyword Difficulty API — Die Ranking-Schwierigkeit in der organischen Suche für eine übermittelte Keyword-Liste vergleichen und jedes verfügbare Keyword mit seinem normalisierten Wert zurückgeben.
  • Keyword Overview API — Eine übermittelte Keyword-Liste um verfügbaren Kontext zu Nachfrage, bezahltem Wettbewerb, Schwierigkeit, monatlichen Suchen und Suchintention anreichern.
  • Keyword Search Volume API — Bekannte Keywords mit verfügbarem Suchvolumen, CPC, bezahltem Wettbewerb und monatlichem Suchverlauf messen.
  • Related Keywords API — Verwandten Suchpfaden ab einer Ausgangsanfrage folgen – mit Steuerung der Tiefe, verfügbaren Keyword-Messwerten, Kontext zur Suchintention und vollständigen Quellzeilen.
  • Search Intent API — Primäre und sekundäre Suchintention für eine übermittelte Keyword-Liste klassifizieren und dabei Quellwahrscheinlichkeiten und vollständige Datensätze erhalten.
  • Google News API — Google-News-Artikel zu einer Suche sammeln, Top-Meldungen zuerst – mit Schlagzeile, Medium, Direktlink zum Artikel, Snippet und Veröffentlichungszeit.

Weitere Plattformen entdecken

Kombinieren Sie SEO-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Google Organic SERP API — FAQ

Google Organic SERP API ist eine Schnittstelle, die eine Live-Ergebnisseite von Google zu einer Abfrage, einem Marktcode, einem Sprachcode und einem Gerät abruft. Sie liefert normalisierte Ziele, Titel, Rangpositionen, Elementtypen und vollständige elementspezifische Details.

Der Playground akzeptiert eine erforderliche query sowie location_code, language_code, device und results_limit. Er nutzt codebasierte Auswahlfelder für Markt und Sprache, um mehrdeutige Kombinationen mit den namensbasierten Alternativen zu vermeiden.

Nein. Eine erweiterte Live-Ergebnisseite kann organische Links, Featured Snippets, Fragen, lokale Ergebnisse, Videos und weitere sichtbare Elemente enthalten; prüfen Sie extra.type für jeden Datensatz.

Ja. Manche Elemente der Ergebnisseite stellen keine Ziel-URL oder nicht jeden Rangwert bereit, daher sollten Clients url, rank.group, rank.absolute und rank.page als nullable behandeln.

Jedes zurückgegebene normalisierte SERP-Element kostet 0,1 SocQ-Credits. Für eine leere Ergebnismenge fallen keine Ergebnisgebühren an, und die angeforderte Tiefe ist eine Schätzung und keine garantierte Anzahl zurückgegebener Elemente.