seo/
keyword-overview

Bis zu 1.000 bekannte Keywords in einem Markt um das verfügbare Suchvolumen, den CPC, den bezahlten Wettbewerb, die Schwierigkeit, monatliche Trends und die Suchintention anreichern – in normalisierten Datensätzen.

Keyword Overview API

Kombinierte Keyword-Kennzahlen
Bis zu 1.000 Keywords
Signale zu Nachfrage und Wettbewerb
0,15 Credits pro Keyword
Bereit
Bereit

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

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
keywordsErforderlichErforderliche Liste mit 1 bis 1.000 bekannten, nicht leeren Keywords, höchstens 80 Zeichen pro Eintrag.
location_codeOptionalPositiver numerischer Code des Suchmarkts. 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 auf den gesamten Batch angewendet wird. 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.
results_limitOptionalOptionale 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.

  1. Bereiten Sie 1 bis 1.000 nicht leere bekannte Keywords vor, die jeweils höchstens 80 Zeichen lang sind.
  2. 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.
  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 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

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

Keyword Overview API — FAQ

Keyword Overview API ist eine Schnittstelle, die 1 bis 1000 bekannte Keywords in einem Suchmarkt anreichert. Sie liefert für jedes Keyword mit Daten die verfügbaren Felder zu Nachfrage, bezahltem Wettbewerb, organischer Schwierigkeit, monatlichen Suchanfragen, Suchintention und vollständiger Quellzeile.

Das erforderliche Array keywords legt den Batch fest, mit 1 bis 1.000 nicht leeren Zeichenfolgen von jeweils bis zu 80 Zeichen. location_code und language_code wählen den Suchkontext, den der Playground verwendet.

Lesen Sie zuerst die normalisierten Felder metrics, monthly_searches und search_intent und prüfen Sie dann extra.keyword_info und extra.keyword_properties auf Quellfelder, die nicht übernommen wurden. Die Schlüssel innerhalb von extra bleiben optional und flexibel.

Nein. CPC und Wettbewerb beschreiben Signale der bezahlten Suche, während keyword_difficulty den Wettbewerb um organische Rankings schätzt; verwenden Sie jedes Feld für den dazu passenden Vergleich.

Jedes übermittelte Keyword kostet 0,15 SocQ-Credits, auch Eingaben, die keine Ergebniszeile liefern. Die Playground-Vorgabe mit zwei Keywords wird daher auf 0,3 Credits geschätzt.