seo/
keyword-search-volume

Bis zu 1.000 bekannte Keywords mit dem verfügbaren Suchvolumen, dem CPC, dem bezahlten Wettbewerb und dem monatlichen Verlauf in normalisierten Datensätzen für einen Markt oder weltweit messen.

Keyword Search Volume API

Messwerte für bekannte Keywords
Bis zu 1.000 Keywords
Monatlicher Nachfrageverlauf
24 Credits pro Anfrage
Bereit
Bereit

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

README

Von SocQ · Aktualisiert am

Keyword Search Volume

Suchvolumen-Datensätze ordnen bekannten Suchbegriffen die geschätzte Nachfrage, den CPC, den bezahlten Wettbewerb und monatliche Beobachtungen für einen gewählten oder weltweiten Suchkontext zu. Diese Messwerte eignen sich für den Nachfragevergleich, die Saisonalitätsprüfung, die Recherche im bezahlten Markt und die Anreicherung von Begriffslisten.

Funktionen der Keyword Search Volume API

  • Batch-Messung bekannter KeywordsMessen Sie 1 bis 1.000 vorbereitete Keywords in einer Anfrage, wobei jede Eingabe auf 80 Zeichen begrenzt ist.
  • Felder zur SuchnachfrageLiefert die verfügbaren search_volume-Werte und monthly_searches-Beobachtungen für jedes Keyword, zu dem Messdaten vorliegen.
  • Kontext der bezahlten SucheHält den verfügbaren CPC, den Wettbewerb, die Wettbewerbsstufe, den Wettbewerbsindex und optionale Gebotsfelder mit dem gemessenen Begriff verbunden.
  • Normalisierte Datensätze mit QuellkontextÜbernimmt stabile Nachfragefelder in metrics und bewahrt zugleich die vollständige zurückgegebene Zeile in extra auf, für optionale Markt- und Gebotsmetadaten.

Parameter der Keyword Search Volume API

ParameterErforderlichBeschreibung
keywordsErforderlichErforderliche Liste mit 1 bis 1.000 bekannten, nicht leeren Keywords, höchstens 80 Zeichen pro Eintrag.
location_codeOptionalOptionaler positiver numerischer Code des Suchmarkts. Der Playground sendet ausdrücklich 2840 für die USA; leeren Sie dieses Feld zusammen mit language_code, um den weltweiten Geltungsbereich des Backends zu verwenden.
location_nameOptionalOptionaler Name des Suchmarkts als Alternative zu location_code. Wenn er ausgefüllt ist, hat er Vorrang vor location_code.
language_codeOptionalOptionaler Sprachcode der Suche mit 2 bis 10 Zeichen. Der Playground sendet ausdrücklich en; leeren Sie dieses Feld zusammen mit location_code, um den weltweiten Geltungsbereich des Backends zu verwenden.
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 Search Volume API

Senden Sie eine begrenzte Liste bekannter Keywords mit optionalen Markt- und Spracheinstellungen und lesen Sie anschließend die normalisierten Nachfragefelder 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 per POST an /v1/seo/keyword-search-volume; geben Sie für eine reproduzierbare marktspezifische Anfrage location_code und language_code an 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 folgen Sie next_cursor, solange has_more den Wert true hat; prüfen Sie extra auf Quellfelder, die nicht übernommen werden.
curl -X POST "https://api.socq.ai/v1/seo/keyword-search-volume" \
  -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 Search Volume API

  • Nachfragevergleich für vorbereitete Listen: Verknüpfen Sie search_volume-Werte mit einer bekannten Begriffsliste und vergleichen Sie die geschätzte Nachfrage innerhalb eines einheitlichen Suchkontexts.
  • Prüfung der monatlichen Saisonalität: Nutzen Sie die Beobachtungen zu year, month und search_volume, um Veränderungen der gemessenen Nachfrage im Zeitverlauf zu untersuchen.
  • Recherche zur Landschaft der bezahlten Suche: Vergleichen Sie CPC, Wettbewerb, Wettbewerbsindex und optionalen Gebotskontext über die gemessenen Keywords hinweg.

Profi-Tipps zur Keyword Search Volume API

  • Fassen Sie vorbereitete Begriffe gegebenenfalls zu einem begrenzten Batch zusammen, denn die Pauschale von 24 Credits gilt für die Anfrage und nicht für jede zurückgegebene Zeile.
  • Geben Sie location_code und language_code ausdrücklich an und halten Sie sie beim Vergleich von Batches unverändert; lassen Sie beide nur weg, wenn der weltweite Geltungsbereich gewollt ist.
  • Senden Sie kein results_limit, weil das Array keywords den Batch dieser Operation steuert und die Operation keine dokumentierte Steuerung für eine Grenze hat.
  • Ordnen Sie zurückgegebene Zeilen über das Keyword zu und behandeln Sie fehlende Datensätze oder Felder mit null als nicht verfügbare Daten und nicht als bestätigte Nachfrage von null.
  • Interpretieren Sie CPC und Wettbewerb als Signale der bezahlten Suche und nicht als Schwierigkeit organischer Rankings, und berücksichtigen Sie nahe Varianten, die ein aggregiertes Volumen teilen können.

Ergänzend zur Keyword Search Volume 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 Overview API — Eine übermittelte Keyword-Liste um verfügbaren Kontext zu Nachfrage, bezahltem Wettbewerb, Schwierigkeit, monatlichen Suchen und Suchintention anreichern.
  • Keywords for Site API — Für eine Website relevante Keywords mit verfügbaren Nachfragewerten, monatlichem Verlauf, Marktkontext und vollständigen Quellzeilen generieren.
  • Keyword Suggestions API — Eine Ausgangsanfrage zu passenden Long-Tail-Begriffen erweitern – mit verfügbaren Nachfragewerten, monatlichem Verlauf, Kontext zur Suchintention und vollständigen Quellzeilen.
  • Ranked Keywords API — Keywords finden, für die eine Domain, Subdomain oder Seite rankt – mit passenden URLs, Positionen, Suchwerten, Suchintention und vollständigen Quellelementen.

Weitere Plattformen entdecken

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

Keyword Search Volume API — FAQ

Keyword Search Volume API ist eine Schnittstelle, die 1 bis 1000 bekannte Keywords in einem gewählten Markt oder weltweit misst. Sie liefert für jedes Keyword mit Daten das verfügbare Suchvolumen, den CPC, den bezahlten Wettbewerb, den monatlichen Verlauf und die vollständigen Felder der Quellzeile.

Das erforderliche Array keywords akzeptiert 1 bis 1.000 nicht leere Zeichenfolgen von jeweils bis zu 80 Zeichen. location_code und language_code sind optional; das Backend verwendet den weltweiten Geltungsbereich, wenn Markt und Sprache fehlen.

Eine fehlende Zeile oder ein Feld mit null bedeutet, dass keine Messdaten verfügbar waren, nicht unbedingt, dass die Nachfrage null ist. Nahe Keyword-Varianten können außerdem einen aggregierten Suchvolumenwert teilen.

Nein. CPC, competition, competition_level, competition_index und die Gebotsfelder beschreiben den Kontext der bezahlten Suche; dieser Endpunkt berechnet keine organische Keyword-Schwierigkeit.

Jede übermittelte Anfrage kostet pauschal 24 SocQ-Credits, unabhängig von der Anzahl der Keywords oder der zurückgegebenen Zeilen innerhalb des akzeptierten Batches.