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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
keywords | Erforderlich | Erforderliche Liste mit 1 bis 1.000 nicht leeren Keywords, höchstens 80 Zeichen pro Eintrag. |
location_code | Optional | Positiver numerischer Code des Suchmarkts. Der Playground verwendet standardmäßig 2840 für die USA. |
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 auf den gesamten Batch angewendet wird. 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 | Optionale 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.
- Bereiten Sie 1 bis 1.000 nicht leere Keywords vor, die jeweils höchstens 80 Zeichen lang sind.
- 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.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler zurückgibt.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- Ranked Keywords API
- Related Keywords API
- Relevant Pages 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