seo/
keyword-overview

Arricchisci fino a 1.000 parole chiave note in un mercato con volume di ricerca, CPC, concorrenza a pagamento, difficoltà, tendenze mensili e intento disponibili in record normalizzati.

Keyword Overview API

Metriche combinate delle parole chiave
Fino a 1.000 parole chiave
Segnali di domanda e concorrenza
0,15 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 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

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

  1. Prepara da 1 a 1.000 parole chiave note non vuote, ciascuna di non più di 80 caratteri.
  2. Invia con POST keywords con location_code e language_code a /v1/seo/keyword-overview, 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 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 true

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

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.

Esplora altre piattaforme

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

Keyword Overview API — FAQ

Keyword Overview API è un’interfaccia programmatica per arricchire da 1 a mille parole chiave note in un mercato di ricerca. Per ogni parola chiave con dati restituisce i campi disponibili di domanda, concorrenza a pagamento, difficoltà organica, ricerche mensili, intento e riga completa della fonte.

L’array keywords obbligatorio definisce il batch, con da 1 a 1.000 stringhe non vuote di massimo 80 caratteri ciascuna. location_code e language_code selezionano il contesto di ricerca usato dal Playground.

Leggi prima metrics, monthly_searches e search_intent normalizzati, poi esamina extra.keyword_info e extra.keyword_properties per i campi della fonte che non sono stati promossi. Le chiavi dentro extra restano facoltative e flessibili.

No. CPC e concorrenza descrivono segnali della ricerca a pagamento, mentre keyword_difficulty stima la concorrenza di posizionamento organico; usa ogni campo per il proprio confronto.

Ogni parola chiave inviata costa 0,15 crediti SocQ, compresi gli input che non producono una riga restituita. L’impostazione predefinita del Playground con due parole chiave è quindi stimata in 0,3 crediti.