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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderliche, nicht leere Suchanfrage. Eine Aufgabe akzeptiert eine Anfrage. |
location_code | Optional | Positiver numerischer Marktcode. Der Playground verwendet standardmäßig 2840 für die USA. |
location_name | Optional | Optionaler Name des Suchmarkts als Alternative zu location_code. Wenn er ausgefüllt ist, hat er Vorrang vor location_code. |
language_code | Optional | Sprachcode der Suche mit 2 bis 10 Zeichen. Der Playground verwendet standardmäßig en. |
language | Optional | Optionaler Name der Suchsprache als Alternative zu language_code. Wenn er ausgefüllt ist, hat er Vorrang vor language_code. |
device | Optional | Gerätekontext der Suche: desktop oder mobile. |
results_limit | Optional | Gewü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.
- Wählen Sie eine nicht leere Abfrage query, einen location_code, einen language_code, ein device und ein results_limit von 1 bis 200.
- Senden Sie die Nutzdaten per POST an /v1/seo/google-organic-serp und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler zurückgibt.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API