Keyword Overview
Keyword-Overview-Datensätze verbinden Suchnachfrage, bezahlten Wettbewerb, organische Schwierigkeit, monatliche Beobachtungen und klassifizierte Suchintention für bekannte Suchbegriffe. Diese sich ergänzenden Signale eignen sich für die Anreicherung von Begriffslisten, den Vergleich von Chancen, die Segmentierung von Recherchen und die zeitbezogene Nachfrageanalyse.
Funktionen der Keyword Overview API
- Batch-Eingabe bekannter KeywordsBewerten Sie 1 bis 1.000 vorbereitete Keywords in einem gewählten Suchmarkt- und Sprachkontext.
- Felder zu Nachfrage und bezahlter SucheBehält das verfügbare Suchvolumen, den CPC, den Wettbewerb, die Wettbewerbsstufe, den Wettbewerbsindex und die monatlichen Beobachtungen für den Vergleich von Nachfrage und bezahltem Markt bei.
- Organische Schwierigkeit und SuchintentionNimmt die verfügbare Keyword-Schwierigkeit und die Informationen zur Suchintention neben den Nachfragefeldern auf, sodass die unterschiedlichen Signale mit demselben Begriff verbunden bleiben.
- Vollständige Overview-ZeileBehält keyword_info, keyword_properties, Metadaten der Suchergebnisse und weitere zurückgegebene Objekte in extra bei, sofern sie vorhanden sind.
Parameter der Keyword Overview API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
keywords | Erforderlich | Erforderliche Liste mit 1 bis 1.000 bekannten, nicht leeren Keywords, höchstens 80 Zeichen pro Eintrag. |
location_code | Optional | Positiver numerischer Code des Suchmarkts. 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 auf den gesamten Batch angewendet wird. 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. |
results_limit | Optional | Optionale Ergebnisgrenze von 1 bis 2.000. |
So verwenden Sie die Keyword Overview API
Senden Sie eine begrenzte Liste bekannter Keywords mit codebasierten Markteinstellungen und lesen Sie normalisierte Felder und vollständige Overview-Objekte aus den asynchronen Ergebnisdatensätzen.
- Bereiten Sie 1 bis 1.000 nicht leere bekannte Keywords vor, die jeweils höchstens 80 Zeichen lang sind.
- Senden Sie keywords zusammen mit location_code und language_code per POST an /v1/seo/keyword-overview 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 prüfen Sie extra.keyword_info oder extra.keyword_properties auf Quellfelder, die nicht in die normalisierten Felder übernommen werden; folgen Sie next_cursor, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/seo/keyword-overview" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords":["keyword research","seo tools"],"location_code":2840,"language_code":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Keyword Overview API
- Anreicherung einer Keyword-Liste: Verknüpfen Sie die zurückgegebenen Felder keyword_info und keyword_properties mit einer vorbereiteten Begriffsliste zu einem gemeinsamen Recherchedatensatz.
- Vergleich von Nachfrage und Wettbewerb: Vergleichen Sie Suchvolumen, CPC, bezahlten Wettbewerb und Keyword-Schwierigkeit, ohne bezahlte und organische Signale als austauschbar zu behandeln.
- Segmentierung nach Intention und Trend: Nutzen Sie die Informationen zur Suchintention zusammen mit den monatlichen Suchbeobachtungen, um bekannte Begriffe nach wahrscheinlichem Zweck und Nachfragemuster zu ordnen.
Profi-Tipps zur Keyword Overview API
- Entfernen Sie Duplikate aus den Keywords, bevor Sie sie senden, denn die Gebühren werden aus der Anzahl der Eingaben berechnet.
- Halten Sie location_code und language_code fest, wenn Sie Begriffe vergleichen, damit der gewählte Suchkontext konsistent bleibt.
- Lassen Sie results_limit weg, weil das Array keywords diesen Batch steuert und die Overview-Operation keine dokumentierte Steuerung für eine Ergebnisgrenze hat.
- Lesen Sie extra.keyword_info und extra.keyword_properties für die vollständige Übersicht, weil nicht jeder direkte Quellwert in ein normalisiertes Feld der obersten Ebene übernommen wird.
- Behandeln Sie fehlende Felder als nicht verfügbare Daten und nicht als numerische 0, und ordnen Sie zurückgegebene Datensätze über das Keyword zu und nicht über die Position im Array.
- Interpretieren Sie CPC und Wettbewerb als Signale der bezahlten Suche, während keyword_difficulty den geschätzten organischen Wettbewerb darstellt.
Verwandte APIs
Ergänzend zur Keyword Overview API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher SEO-Daten benötigen.
- Google Organic SERP API — Eine aktuelle Google-Ergebnisseite per Suchanfrage und Markt abrufen – mit normalisierten Zielen, Rängen, Elementtypen und vollständigen Ergebnisdetails.
- 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 Search Volume API — Bekannte Keywords mit verfügbarem Suchvolumen, CPC, bezahltem Wettbewerb und monatlichem Suchverlauf messen.
- Keywords for Site API — Für eine Website relevante Keywords mit verfügbaren Nachfragewerten, monatlichem Verlauf, Marktkontext und vollständigen Quellzeilen generieren.
- 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.
- 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 News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API