Keyword Overview
I record di panoramica delle parole chiave combinano domanda di ricerca, concorrenza a pagamento, difficoltà organica, osservazioni mensili e intento classificato per termini di ricerca noti. Questi segnali complementari supportano l’arricchimento di elenchi di termini, il confronto delle opportunità, la segmentazione della ricerca e l’analisi della domanda nel tempo.
Funzionalità della Keyword Overview API
- Input in batch di parole chiave noteValuta da 1 a 1.000 parole chiave preparate in un unico contesto selezionato di mercato e lingua di ricerca.
- Campi di domanda e ricerca a pagamentoConserva, quando disponibili, volume di ricerca, CPC, concorrenza, livello di concorrenza, indice di concorrenza e osservazioni mensili per confrontare domanda e mercato a pagamento.
- Difficoltà organica e intentoInclude, quando disponibili, la difficoltà della parola chiave e le informazioni sull’intento di ricerca accanto ai campi di domanda, così segnali distinti restano collegati allo stesso termine.
- Riga di panoramica completaMantiene in extra, quando presenti, keyword_info, keyword_properties, i metadati dei risultati di ricerca e gli altri oggetti restituiti.
Parametri della Keyword Overview 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 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 Overview API
Invia un elenco limitato di parole chiave note con impostazioni di mercato basate su codici, poi leggi i campi normalizzati e gli oggetti di panoramica completi 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 con location_code e language_code a /v1/seo/keyword-overview, 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 ed esamina extra.keyword_info o extra.keyword_properties per i campi della fonte non promossi; segui next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/seo/keyword-overview" \
-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 Overview API
- Arricchimento di elenchi di parole chiave: Abbina i campi keyword_info e keyword_properties restituiti a un elenco di termini preparato per ottenere un record di ricerca comune.
- Confronto tra domanda e concorrenza: Confronta volume di ricerca, CPC, concorrenza a pagamento e difficoltà della parola chiave senza trattare come intercambiabili i segnali a pagamento e organici.
- Segmentazione per intento e tendenza: Usa le informazioni sull’intento di ricerca con le osservazioni mensili di ricerca per organizzare i termini noti in base allo scopo probabile e all’andamento della domanda.
Consigli degli esperti per la Keyword Overview API
- Elimina i duplicati dalle parole chiave prima dell’invio, perché gli addebiti sono calcolati in base al numero di input.
- Mantieni fissi location_code e language_code quando confronti i termini, così il contesto di ricerca selezionato resta coerente.
- Ometti results_limit, perché l’array keywords controlla questo batch e l’operazione di panoramica non ha un controllo del limite dei risultati documentato.
- Leggi extra.keyword_info e extra.keyword_properties per la panoramica completa, perché non ogni valore diretto della fonte viene promosso a un campo normalizzato di primo livello.
- Tratta i campi mancanti come dati non disponibili e non come zero numerico, e abbina i record restituiti per parola chiave e non per posizione nell’array.
- Interpreta CPC e concorrenza come segnali della ricerca a pagamento, mentre keyword_difficulty rappresenta la concorrenza organica stimata.
API correlate
Oltre alla Keyword Overview 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 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.
- Related Keywords API — Segue i percorsi delle ricerche correlate a partire da una query di partenza con controlli di profondità, misurazioni delle parole chiave, 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.
- Keyword Suggestions API
- Ranked 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