seo/
keyword-suggestions

Eine Seed-Abfrage in einem gewählten Suchmarkt zu Long-Tail-Begriffen erweitern – mit passenden Keywords, verfügbaren Nachfragekennzahlen, monatlichem Verlauf und vollständigen Quellzeilen.

Keyword Suggestions API

Abgleich mit Seed-Phrase
Long-Tail-Begriffe
Offset-Fenster
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

Keyword Suggestions

Keyword-Vorschläge sind Long-Tail-Suchbegriffe, die ein Seed-Wort oder eine Seed-Phrase mit Ergänzungen davor, danach oder darin enthalten; ihre Datensätze können Signale zu Nachfrage, Kosten, Wettbewerb, monatlichem Verlauf und Suchintention enthalten. Diese passenden Begriffe und Messwerte eignen sich für die Erweiterung von Suchanfragen, die Recherche für Content-Briefings, die Analyse der bezahlten Suche und den kontrollierten Vergleich von Formulierungsvarianten.

Funktionen der Keyword Suggestions API

  • Volltext-Erweiterung eines SeedsLiefert Suchbegriffe, die die übermittelten Seed-Wörter enthalten, und erlaubt dabei Ergänzungen davor, danach oder innerhalb der Phrase sowie eine abweichende Wortreihenfolge.
  • Objekte mit Keyword-MesswertenBewahrt das verfügbare Suchvolumen, den CPC, den bezahlten Wettbewerb, den monatlichen Verlauf und Details zur Schwierigkeit in den Quelldaten jedes Datensatzes auf.
  • Kontext zur SuchintentionStellt die verfügbaren Informationen zur primären und sekundären Intention für jedes passende Keyword bereit, ohne sie als Ranking-Empfehlung zu behandeln.
  • Kontrollierte ErgebnisfensterAkzeptiert eine Ergebnisobergrenze von 1 bis 1.000 und einen nullbasierten Zeilen-Offset, um ein späteres Quellfenster abzurufen.

Parameter der Keyword Suggestions API

ParameterErforderlichBeschreibung
queryErforderlichErforderliches, nicht leeres Seed-Keyword oder eine Seed-Phrase. Eine Aufgabe akzeptiert eine Abfrage.
location_codeOptionalPositiver numerischer Code des Suchmarkts. Der Playground verwendet standardmäßig 2840.
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.
results_limitOptionalGewünschtes Maximum von 1 bis 1.000 Vorschlägen. Es können weniger Zeilen zurückgegeben werden.
offsetOptionalNullbasierte Anzahl der Quellzeilen, die übersprungen werden, bevor das angeforderte Ergebnisfenster gesammelt wird.

So verwenden Sie die Keyword Suggestions API

Senden Sie eine Seed-Abfrage mit Marktparametern und einem begrenzten Ergebnisfenster und lesen Sie anschließend jeden Vorschlag aus der abgeschlossenen asynchronen Aufgabe.

  1. Wählen Sie eine nicht leere Abfrage query, einen location_code, einen language_code, ein results_limit von 1 bis 1.000 und einen offset von 0 oder höher.
  2. Senden Sie die Nutzdaten per POST an /v1/seo/keyword-suggestions 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/keyword-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"keyword research","location_code":2840,"language_code":"en","results_limit":100}'

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

Anwendungsfälle der Keyword Suggestions API

  • Erweiterung zu Long-Tail-Suchanfragen: Nutzen Sie eine Seed-Phrase und den zurückgegebenen Keyword-Text, um längere Suchvarianten zu sammeln, die die ursprünglichen Wörter beibehalten.
  • Recherche von Kandidaten für Content-Briefings: Kombinieren Sie passende Begriffe mit den verfügbaren Feldern zu Volumen, monatlichem Verlauf, Schwierigkeit und Suchintention, um eine prüfbare Keyword-Menge zusammenzustellen.
  • Keyword-Vergleich für die bezahlte Suche: Vergleichen Sie die verfügbaren Messwerte zu CPC und bezahltem Wettbewerb über Formulierungsvarianten hinweg, bevor Sie Kandidaten an einen Planungs-Workflow übergeben.

Profi-Tipps zur Keyword Suggestions API

  • Verwenden Sie eine spezifische Seed-Phrase, wenn Sie eng passende Long-Tail-Varianten benötigen; wählen Sie einen semantischen Keyword-Endpunkt, wenn die Begriffe die Seed-Wörter nicht enthalten müssen.
  • Behandeln Sie offset als Zeilenanzahl und nicht als Seitennummer, und erhöhen Sie ihn um die Größe des Quellfensters, das Sie überspringen möchten.
  • Erfassen Sie query, location_code, language_code, results_limit und offset gemeinsam, weil sich die Quellreihenfolge zwischen sonst gleichartigen Anfragen später ändern kann.
  • Lesen Sie keyword und search_intent zuerst aus den normalisierten Feldern und prüfen Sie dann extra.keyword_info und extra.keyword_properties auf direkte Messwert-Objekte, die nicht übernommen wurden.
  • Entfernen Sie Duplikate wiederholter Fenster anhand von Keyword plus Markt und Sprache, und rechnen Sie damit, dass jede optionale Kennzahl und jedes verschachtelte Objekt fehlen kann.

Ergänzend zur Keyword Suggestions 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.
  • 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.

Weitere Plattformen entdecken

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

Keyword Suggestions API — FAQ

Keyword Suggestions API ist eine Schnittstelle, die Long-Tail-Suchbegriffe zu einer Seed-Abfrage, einem Marktcode und einem Sprachcode findet. Sie liefert passende Keywords, verfügbare Details zu Nachfrage und Wettbewerb, den monatlichen Verlauf, den Kontext zur Suchintention und vollständige Quellzeilen.

Vorschläge enthalten die übermittelten Seed-Wörter mit Ergänzungen davor, danach oder darin, ihre Wortreihenfolge kann aber abweichen. Nutzen Sie den Endpunkt für die Volltext-Erweiterung und nicht für breite semantische Alternativen.

results_limit ist eine Obergrenze von 1 bis 1.000, während offset die Anzahl der vorherigen Quellzeilen angibt, die übersprungen werden. offset ist keine Seitennummer, und die Quellreihenfolge kann sich im Lauf der Zeit ändern.

Stabile Felder für Keyword und verfügbare Suchintention sind normalisiert, während direkte Suchmesswerte und Keyword-Eigenschaften in extra.keyword_info und extra.keyword_properties bleiben können. Clients sollten jeden optionalen Wert als nullable behandeln.

Jeder zurückgegebene Vorschlag kostet 0,1 SocQ-Credits. Für eine leere Ergebnismenge fallen keine Ergebnisgebühren an, und results_limit liefert die Schätzung vor der Anfrage und keine garantierte endgültige Anzahl.