seo/
keyword-difficulty

Die Schwierigkeit organischer Rankings für bis zu 1.000 Keywords in einem Markt vergleichen – mit jedem verfügbaren Keyword und seinem Score von 0–100 in normalisierten Datensätzen.

Keyword Difficulty API

Bis zu 1.000 Keywords
Schwierigkeits-Score von 0–100
Marktspezifischer Vergleich
0,1 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 Difficulty

Keyword-Difficulty-Scores drücken den geschätzten relativen Wettbewerb um ein organisches Ranking für einen Suchbegriff aus, wobei höhere Werte eine größere Schwierigkeit anzeigen. Diese Signale auf Keyword-Ebene eignen sich für die Priorisierung, die Segmentierung von Recherchegruppen und den Vergleich über eine vorbereitete Begriffsliste hinweg.

Funktionen der Keyword Difficulty API

  • Batch-Eingabe von KeywordsBewerten Sie 1 bis 1.000 nicht leere Keywords in einer Aufgabe, wobei für den gesamten Batch derselbe gewählte Markt- und Sprachkontext gilt.
  • Normalisierte Kennzahl für die SchwierigkeitLiefert jedes verfügbare Keyword mit metrics.keyword_difficulty, in der Regel auf einer Skala von 0–100 für den direkten Vergleich.
  • Vollständiger QuellkontextBewahrt die vollständige zurückgegebene Zeile in extra auf, damit Clients zusätzliche Quellfelder prüfen können, ohne sie als stabiles normalisiertes Schema zu behandeln.

Parameter der Keyword Difficulty API

ParameterErforderlichBeschreibung
keywordsErforderlichErforderliche Liste mit 1 bis 1.000 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 Difficulty API

Senden Sie eine begrenzte Keyword-Liste mit codebasierten Markteinstellungen und lesen Sie anschließend die verfügbaren normalisierten Scores aus der abgeschlossenen asynchronen Aufgabe.

  1. Bereiten Sie 1 bis 1.000 nicht leere 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-difficulty 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.
curl -X POST "https://api.socq.ai/v1/seo/keyword-difficulty" \
  -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 Difficulty API

  • Priorisierung einer Keyword-Liste: Vergleichen Sie metrics.keyword_difficulty über eine vorbereitete Begriffsmenge hinweg, um die redaktionelle oder recherchebezogene Vorauswahl um ein Wettbewerbssignal zu ergänzen.
  • Segmentierung nach Schwierigkeitsbereichen: Fassen Sie zurückgegebene Scores in intern definierten Bereichen zusammen, um Recherche-Warteschlangen für Keywords mit geringerer und höherer Schwierigkeit zu organisieren.
  • Marktvergleich: Führen Sie dieselbe Keyword-Liste mit kontrollierten Werten für location_code und language_code aus, um die geschätzte Schwierigkeit über verschiedene Suchkontexte hinweg zu vergleichen.

Profi-Tipps zur Keyword Difficulty API

  • Entfernen Sie Duplikate aus den Keywords, bevor Sie sie senden, damit wiederholte Begriffe nicht mehrfach eingabebasierte Gebühren verursachen.
  • Halten Sie location_code und language_code unverändert, wenn Sie Scores innerhalb einer Recherchemenge vergleichen.
  • Lassen Sie results_limit weg, denn dieser Batch wird durch das Array keywords gesteuert und nicht durch eine Grenze für zurückgegebene Ergebnisse.
  • Ordnen Sie Ergebnisse über das Keyword zu und nicht über die Position im Array, weil nicht verfügbare Begriffe in den zurückgegebenen Datensätzen fehlen können.
  • Unterscheiden Sie beim Bilden von Score-Bereichen einen numerischen Score von 0 von einem fehlenden Wert für keyword_difficulty.

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

Keyword Difficulty API — FAQ

Keyword Difficulty API ist eine Schnittstelle, die die Schwierigkeit organischer Rankings für 1 bis 1000 übermittelte Keywords in einem Suchmarkt vergleicht. Sie liefert jedes verfügbare Keyword mit einem normalisierten Schwierigkeits-Score von 0–100 und der vollständigen Quellzeile.

Eine Aufgabe akzeptiert 1 bis 1.000 nicht leere Keyword-Zeichenfolgen mit jeweils bis zu 80 Zeichen. Die Größe des Batches legt das Array keywords fest.

Nicht unbedingt. Ein Keyword kann fehlen oder keine Schwierigkeitskennzahl haben, wenn sich kein Score berechnen lässt; Clients sollten daher nicht von genau einer zurückgegebenen Zeile pro Eingabe ausgehen.

Nein. Der Score ist eine vergleichende Schätzung der Schwierigkeit organischer Rankings im gewählten Markt und weder eine Ranking-Wahrscheinlichkeit noch eine Traffic-Prognose oder eine websitespezifische Empfehlung.

Jedes übermittelte Keyword kostet 0,1 SocQ-Credits, auch Keywords, für die keine Ergebniszeile verfügbar ist. Eine Playground-Anfrage mit zwei Keywords wird daher auf 0,2 Credits geschätzt.