seo/
keyword-search-volume

Misura fino a 1.000 parole chiave note con volume di ricerca, CPC, concorrenza a pagamento e cronologia mensile disponibili, in record normalizzati per un mercato o a livello mondiale.

Keyword Search Volume API

Misurazioni di parole chiave note
Fino a 1.000 parole chiave
Cronologia mensile della domanda
24 crediti per richiesta
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 Search Volume

I record del volume di ricerca delle parole chiave abbinano termini di ricerca noti a domanda stimata, CPC, concorrenza a pagamento e osservazioni mensili, per un contesto di ricerca selezionato o mondiale. Queste misurazioni supportano il confronto della domanda, l’analisi della stagionalità, la ricerca sul mercato a pagamento e l’arricchimento di elenchi di termini.

Funzionalità della Keyword Search Volume API

  • Misurazione in batch di parole chiave noteMisura da 1 a 1.000 parole chiave preparate in una sola richiesta, con ogni input limitato a 80 caratteri.
  • Campi della domanda di ricercaRestituisce i valori search_volume e le osservazioni monthly_searches disponibili per ogni parola chiave che ha dati di misurazione.
  • Contesto del mercato a pagamentoMantiene collegati al termine misurato CPC, concorrenza, livello di concorrenza, indice di concorrenza e campi facoltativi di offerta, quando disponibili.
  • Record normalizzati con contesto della fontePromuove in metrics i campi stabili della domanda e conserva in extra l’intera riga restituita, con i metadati facoltativi di mercato e offerta.

Parametri della Keyword Search Volume API

ParametriObbligatorioDescrizione
keywordsObbligatorioElenco obbligatorio da 1 a 1.000 parole chiave note e non vuote, con un massimo di 80 caratteri per elemento.
location_codeFacoltativoCodice numerico positivo facoltativo del mercato di ricerca. Il Playground invia esplicitamente 2840 per gli Stati Uniti; svuota questo campo insieme a language_code per usare l’ambito mondiale del backend.
location_nameFacoltativoNome facoltativo del mercato di ricerca, alternativo a location_code. Se compilato, ha la precedenza su location_code.
language_codeFacoltativoCodice facoltativo della lingua di ricerca, da 2 a 10 caratteri. Il Playground invia esplicitamente en; svuota questo campo insieme a location_code per usare l’ambito mondiale del backend.
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 Search Volume API

Invia un elenco limitato di parole chiave note con impostazioni facoltative di mercato e lingua, poi leggi i campi normalizzati della domanda dai record di risultato asincroni.

  1. Prepara da 1 a 1.000 parole chiave note non vuote, ciascuna di non più di 80 caratteri.
  2. Invia con POST keywords a /v1/seo/keyword-search-volume; includi location_code e language_code per una richiesta riproducibile specifica per mercato, 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 e segui next_cursor finché has_more è true; esamina extra per i campi della fonte non promossi.
curl -X POST "https://api.socq.ai/v1/seo/keyword-search-volume" \
  -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 Search Volume API

  • Confronto della domanda su un elenco preparato: Abbina i valori search_volume a un elenco di termini noto e confronta la domanda stimata all’interno di un contesto di ricerca coerente.
  • Analisi della stagionalità mensile: Usa le osservazioni di year, month e search_volume per esaminare le variazioni della domanda misurata nel tempo.
  • Ricerca sul panorama della ricerca a pagamento: Confronta CPC, concorrenza, indice di concorrenza e contesto facoltativo delle offerte tra le parole chiave misurate.

Consigli degli esperti per la Keyword Search Volume API

  • Riunisci i termini preparati in un batch limitato quando opportuno, perché l’addebito fisso di 24 crediti si applica alla richiesta e non a ogni riga restituita.
  • Mantieni espliciti e invariati location_code e language_code quando confronti i batch; omettili entrambi solo se vuoi l’ambito mondiale.
  • Non inviare results_limit, perché l’array keywords controlla il batch di questa operazione e l’operazione non ha un controllo del limite documentato.
  • Abbina le righe restituite per parola chiave e tratta i record mancanti o i campi null come dati non disponibili e non come domanda zero confermata.
  • Interpreta CPC e concorrenza come segnali della ricerca a pagamento, non come difficoltà di posizionamento organico, e tieni conto delle varianti ravvicinate che possono condividere un volume aggregato.

Oltre alla Keyword Search Volume 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 Difficulty API — Confronta la difficoltà di posizionamento organico per un gruppo di parole chiave inviato, restituendo ogni parola chiave disponibile con il suo punteggio normalizzato.
  • Keyword Overview API — Arricchisce un gruppo di parole chiave inviato con domanda, concorrenza a pagamento, difficoltà, ricerche mensili e contesto dell’intento, 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.
  • Ranked Keywords API — Trova le parole chiave per cui si posizionano un dominio, un sottodominio o una pagina, con URL corrispondenti, posizioni, misurazioni di ricerca, intento ed elementi di origine completi.

Esplora altre piattaforme

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

Keyword Search Volume API — FAQ

Keyword Search Volume API è un’interfaccia programmatica per misurare da 1 a mille parole chiave note in un mercato selezionato o a livello mondiale. Per ogni parola chiave con dati restituisce volume di ricerca, CPC, concorrenza a pagamento, cronologia mensile e campi della riga completa della fonte, se disponibili.

L’array keywords obbligatorio accetta da 1 a 1.000 stringhe non vuote di massimo 80 caratteri ciascuna. location_code e language_code sono facoltativi; il backend usa l’ambito mondiale quando mercato e lingua sono omessi.

Una riga mancante o un campo null significa che i dati di misurazione non erano disponibili, non necessariamente che la domanda sia zero. Anche le varianti ravvicinate di una parola chiave possono condividere un valore aggregato del volume di ricerca.

No. I campi CPC, competition, competition_level, competition_index e bid descrivono il contesto della ricerca a pagamento; questo endpoint non calcola la difficoltà organica delle parole chiave.

Ogni richiesta inviata costa 24 crediti SocQ fissi, a prescindere dal numero di parole chiave o di righe restituite all’interno del batch accettato.