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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderliches, nicht leeres Seed-Keyword oder eine Seed-Phrase. Eine Aufgabe akzeptiert eine Abfrage. |
location_code | Optional | Positiver numerischer Code des Suchmarkts. Der Playground verwendet standardmäßig 2840. |
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. |
results_limit | Optional | Gewünschtes Maximum von 1 bis 1.000 Vorschlägen. Es können weniger Zeilen zurückgegeben werden. |
offset | Optional | Nullbasierte 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.
- 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.
- Senden Sie die Nutzdaten per POST an /v1/seo/keyword-suggestions 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/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 trueAnwendungsfä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.
Verwandte APIs
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.
- Ranked Keywords API
- Relevant Pages API
- Search Intent 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