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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
keywords | Obbligatorio | Elenco obbligatorio da 1 a 1.000 parole chiave note e non vuote, con un massimo di 80 caratteri per elemento. |
location_code | Facoltativo | Codice 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_name | Facoltativo | Nome facoltativo del mercato di ricerca, alternativo a location_code. Se compilato, ha la precedenza su location_code. |
language_code | Facoltativo | Codice 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. |
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 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.
- Prepara da 1 a 1.000 parole chiave note non vuote, ciascuna di non più di 80 caratteri.
- 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.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
- 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 trueCasi 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.
API correlate
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.
- Related Keywords API
- Relevant Pages API
- Search Intent 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