seo/
keyword-difficulty

Confronta la difficoltà di posizionamento organico di fino a 1.000 parole chiave in un mercato, restituendo ogni parola chiave disponibile con il suo punteggio da 0 a 100 in record normalizzati.

Keyword Difficulty API

Fino a 1.000 parole chiave
Punteggio di difficoltà da 0 a 100
Confronto specifico per mercato
0,1 crediti per parola chiave
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
keywordsObbligatorioElenco obbligatorio da 1 a 1.000 parole chiave non vuote, con un massimo di 80 caratteri per elemento.
location_codeFacoltativoCodice numerico positivo del mercato di ricerca. Il Playground usa per impostazione predefinita 2840, cioè gli Stati Uniti.
location_nameFacoltativoNome facoltativo del mercato di ricerca, alternativo a location_code. Se compilato, ha la precedenza su location_code.
language_codeFacoltativoCodice della lingua di ricerca, da 2 a 10 caratteri, applicato al batch. Il Playground usa per impostazione predefinita en.
languageFacoltativoNome facoltativo della lingua di ricerca, alternativo a language_code. Se compilato, ha la precedenza su language_code.
results_limitFacoltativoLimite 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.

  1. Prepara da 1 a 1.000 parole chiave non vuote, ciascuna di non più di 80 caratteri.
  2. Invia con POST keywords con location_code e language_code a /v1/seo/keyword-difficulty, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

Combina i dati di SEO con i dati pubblici delle altre piattaforme social supportate.

Keyword Difficulty API — FAQ

Keyword Difficulty API è un’interfaccia programmatica per confrontare la difficoltà di posizionamento organico di un massimo di mille parole chiave inviate in un unico mercato di ricerca. Restituisce ogni parola chiave disponibile con un punteggio di difficoltà normalizzato da 0 a 100 e la riga completa della fonte.

Un’attività accetta da 1 a 1.000 stringhe di parole chiave non vuote, ciascuna fino a 80 caratteri. L’array keywords definisce la dimensione del batch.

Non necessariamente. Una parola chiave può essere omessa o priva di metrica di difficoltà quando non è possibile calcolare un punteggio, quindi i client non dovrebbero dare per scontata una riga restituita per ogni input.

No. Il punteggio è una stima comparativa della difficoltà di posizionamento organico nel mercato selezionato, non una probabilità di posizionamento, una previsione del traffico o una raccomandazione specifica per un sito.

Ogni parola chiave inviata costa 0,1 crediti SocQ, comprese quelle per cui non è disponibile alcuna riga di risultato. Una richiesta del Playground con due parole chiave è quindi stimata in 0,2 crediti.