Keyword Difficulty
I punteggi di difficoltà delle parole chiave esprimono la concorrenza relativa stimata per posizionarsi in modo organico su un termine di ricerca, dove valori più alti indicano una difficoltà maggiore. Questi segnali a livello di parola chiave supportano la definizione delle priorità, la segmentazione dei gruppi di ricerca e il confronto su un elenco di termini preparato.
Funzionalità della Keyword Difficulty API
- Input di parole chiave in batchValuta da 1 a 1.000 parole chiave non vuote in una sola attività, applicando al batch lo stesso contesto di mercato e lingua selezionato.
- Metrica di difficoltà normalizzataRestituisce ogni parola chiave disponibile con metrics.keyword_difficulty, di norma espressa su una scala da 0 a 100 per un confronto diretto.
- Contesto completo della fonteConserva in extra l’intera riga restituita, così i client possono esaminare altri campi della fonte senza trattarli come uno schema normalizzato stabile.
Parametri della Keyword Difficulty API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
keywords | Obbligatorio | Elenco obbligatorio da 1 a 1.000 parole chiave non vuote, con un massimo di 80 caratteri per elemento. |
location_code | Facoltativo | Codice numerico positivo del mercato di ricerca. Il Playground usa per impostazione predefinita 2840, cioè gli Stati Uniti. |
location_name | Facoltativo | Nome facoltativo del mercato di ricerca, alternativo a location_code. Se compilato, ha la precedenza su location_code. |
language_code | Facoltativo | Codice della lingua di ricerca, da 2 a 10 caratteri, applicato al batch. Il Playground usa per impostazione predefinita en. |
language | Facoltativo | Nome facoltativo della lingua di ricerca, alternativo a language_code. Se compilato, ha la precedenza su language_code. |
results_limit | Facoltativo | Limite facoltativo dei risultati da 1 a 2.000. |
Come usare la Keyword Difficulty API
Invia un elenco limitato di parole chiave con impostazioni di mercato basate su codici, poi leggi i punteggi normalizzati disponibili dall’attività asincrona completata.
- Prepara da 1 a 1.000 parole chiave non vuote, ciascuna di non più di 80 caratteri.
- Invia con POST keywords con location_code e language_code a /v1/seo/keyword-difficulty, poi salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
- Leggi data.results.items, poi segui next_cursor finché has_more è true.
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 trueCasi d’uso della Keyword Difficulty API
- Definizione delle priorità di un elenco di parole chiave: Confronta metrics.keyword_difficulty su un insieme di termini preparato per aggiungere un segnale di concorrenza alla selezione editoriale o di ricerca.
- Segmentazione per fasce di difficoltà: Raggruppa i punteggi restituiti in intervalli definiti internamente per organizzare le code di ricerca delle parole chiave a difficoltà più bassa e più alta.
- Confronto tra mercati: Esegui lo stesso elenco di parole chiave con valori controllati di location_code e language_code per confrontare la difficoltà stimata tra contesti di ricerca.
Consigli degli esperti per la Keyword Difficulty API
- Elimina i duplicati dalle parole chiave prima dell’invio, così i termini ripetuti non consumano addebiti ripetuti basati sull’input.
- Mantieni invariati location_code e language_code quando confronti i punteggi all’interno di uno stesso insieme di ricerca.
- Ometti results_limit, perché questo batch è controllato dall’array keywords e non da un limite di risultati restituiti.
- Abbina i risultati per parola chiave e non per posizione nell’array, perché i termini non disponibili possono essere omessi dai record restituiti.
- Distingui un punteggio numerico pari a 0 da un valore keyword_difficulty assente quando costruisci le fasce di punteggio.
API correlate
Oltre alla Keyword Difficulty API, usa queste API quando ti serve un altro tipo di dati pubblici di SEO.
- Google Organic SERP API — Recupera una pagina di risultati Google in tempo reale per query e mercato con destinazioni, posizioni, tipi di elemento e dettagli completi dei risultati normalizzati.
- Keyword Overview API — Arricchisce un gruppo di parole chiave inviato con domanda, concorrenza a pagamento, difficoltà, ricerche mensili e contesto dell’intento, se disponibili.
- Keyword Search Volume API — Misura parole chiave note con volume di ricerca, CPC, concorrenza a pagamento e cronologia mensile delle ricerche, se disponibili.
- Keywords for Site API — Genera parole chiave rilevanti per un sito web con misurazioni della domanda, cronologia mensile, contesto del mercato e righe di origine complete, se disponibili.
- Keyword Suggestions API — Espande una query di partenza in termini long-tail corrispondenti con misurazioni della domanda, cronologia mensile, contesto dell’intento e righe di origine complete, se disponibili.
- Search Intent API — Classifica l’intento di ricerca primario e secondario per un gruppo di parole chiave inviato, conservando le probabilità di origine e i record completi.
- 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