seo/
related-keywords

Suchanfragen entdecken, die über Pfade ähnlicher Suchanfragen mit einem Seed verbunden sind – mit Keyword-Kennzahlen, monatlicher Nachfrage, Suchintention und Beziehungstiefe in normalisierten Datensätzen.

Related Keywords API

Graph ähnlicher Suchanfragen
Steuerung der Tiefe
Keyword-Messwerte
0,1 Credits pro Ergebnis
Bereit
README

Von SocQ · Aktualisiert am

Related Keywords

Verwandte Keywords sind Suchanfragen, die über den Graphen der ähnlichen Suchanfragen verbunden sind, samt Signalen zu Tiefe, Nachfrage, CPC, Wettbewerb, Schwierigkeit und Suchintention. Diese Beziehungen und Messwerte eignen sich für die Entdeckung benachbarter Themen, die Erweiterung von Themenlandkarten und den Vergleich von Kandidaten.

Funktionen der Related Keywords API

  • Erweiterung über den Graphen ähnlicher SuchanfragenFolgt direkten oder rekursiven Beziehungen zwischen Suchanfragen ausgehend von einem Seed mit Tiefenwerten von 0 bis 4, ohne dass die Phrase enthalten sein muss.
  • Objekte mit Keyword-MesswertenLiefert für jede verbundene Suchanfrage das verfügbare Suchvolumen, den CPC, den bezahlten Wettbewerb, den monatlichen Verlauf, die Schwierigkeit und Informationen zur Suchintention.
  • Erhaltener BeziehungskontextBehält die Quelltiefe, die Pfade verwandter Keywords, das vollständige Objekt keyword_data und weitere variable Felder in extra für die detaillierte Interpretation des Graphen bei.

Parameter der Related Keywords API

ParameterErforderlichBeschreibung
queryErforderlichErforderliches, nicht leeres Seed-Keyword oder eine Seed-Phrase. Eine Aufgabe akzeptiert eine Abfrage.
location_codeOptionalOptionaler positiver numerischer Code des Suchmarkts.
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.
languageOptionalOptionaler Name der Suchsprache als Alternative zu language_code. Wenn er ausgefüllt ist, hat er Vorrang vor language_code.
depthOptionalBeziehungstiefe von 0 bis 4. Der Standardwert 1 liefert direkt verbundene Suchanfragen.
results_limitOptionalGewünschtes Maximum von 1 bis 1.000 verwandten Keywords. 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 Related Keywords API

Senden Sie eine Seed-Abfrage mit Beziehungstiefe, Marktparametern und einem begrenzten Ergebnisfenster und lesen Sie anschließend die verwandten Datensätze aus der abgeschlossenen asynchronen Aufgabe.

  1. Wählen Sie eine nicht leere Abfrage query, einen location_code, einen language_code, eine depth von 0 bis 4, 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/related-keywords 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/related-keywords" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"keyword research","depth":1,"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 Related Keywords API

  • Entdeckung benachbarter Themen: Nutzen Sie den zurückgegebenen Text der Suchanfragen und den Beziehungskontext, um verbundene Themen zu finden, die die Seed-Phrase nicht enthalten müssen.
  • Erweiterung von Themenlandkarten: Vergleichen Sie Tiefe und Pfade verwandter Keywords, um einen Seed von direkten Nachbarn aus zu einem breiteren Graphen von Suchanfragen auszubauen.
  • Bewertung von Keyword-Kandidaten: Kombinieren Sie verwandte Begriffe mit den verfügbaren Angaben zu Nachfrage, Kosten, Wettbewerb, Schwierigkeit, monatlichem Verlauf und Suchintention, um eine prüfbare Kandidatenmenge vorzubereiten.

Profi-Tipps zur Related Keywords API

  • Beginnen Sie für direkte Beziehungen mit depth 1; erhöhen Sie die Tiefe nur, wenn sich ein breiterer Graph mit einem größeren und womöglich weniger direkten Kandidatenpool lohnt.
  • Verwenden Sie stattdessen Keyword Suggestions, wenn jeder zurückgegebene Begriff die Seed-Wörter behalten soll, denn verwandte Suchanfragen können andere Formulierungen nutzen.
  • Halten Sie query, location_code, language_code und depth fest, wenn Sie Ergebnisfenster vergleichen, damit Beziehungs- und Marktkontext vergleichbar bleiben.
  • Behandeln Sie offset als Zeilenanzahl und nicht als Seitennummer, und erhöhen Sie ihn um die Anzahl der Quellzeilen, die Sie überspringen möchten.
  • Lesen Sie keyword, metrics, monthly_searches und search_intent zuerst aus den normalisierten Feldern und prüfen Sie dann extra auf Quelltiefe und Beziehungspfade.
  • Schließen Sie aus der Nähe im Graphen nicht auf identische Suchintention, und rechnen Sie damit, dass optionale Messwerte und variable Felder in extra fehlen können.

Ergänzend zur Related Keywords 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.
  • Keyword Suggestions API — Eine Ausgangsanfrage zu passenden Long-Tail-Begriffen erweitern – mit verfügbaren Nachfragewerten, monatlichem Verlauf, 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.

Related Keywords API — FAQ

Related Keywords API ist eine Schnittstelle, die Suchanfragen findet, die über den Graphen ähnlicher Suchanfragen eines gewählten Suchmarkts mit einem Seed verbunden sind. Sie liefert Keyword-Text, verfügbare Messwerte, den monatlichen Verlauf, Informationen zur Suchintention, die Beziehungstiefe und vollständige Quellzeilen.

depth akzeptiert 0 bis 4: 0 steht für den übermittelten Seed, 1 deckt direkte Beziehungen ab, und höhere Werte erweitern rekursiv. Größere Tiefen können einen breiteren und weniger direkt verwandten Kandidatenpool erzeugen.

Nein. Verbindungen über ähnliche Suchanfragen können andere Formulierungen liefern; verwenden Sie daher Keyword Suggestions, wenn Long-Tail-Varianten verlangt sind, die die Phrase enthalten.

Normalisierte Datensätze können Keyword-Text, Suchvolumen, CPC, bezahlten Wettbewerb, Keyword-Schwierigkeit, monatliche Suchanfragen und Informationen zur Suchintention enthalten. Die Quelltiefe der Beziehung, verwandte Pfade und das vollständige Objekt keyword_data bleiben in extra.

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 Quelle kann weniger Zeilen als angefordert zurückgeben.

Jedes zurückgegebene verwandte Keyword 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.