seo/
keyword-suggestions

Espandi una query di partenza in un mercato di ricerca scelto in termini long-tail, con parole chiave corrispondenti, metriche di domanda disponibili, cronologia mensile e righe complete della fonte.

Keyword Suggestions API

Corrispondenza con la frase di partenza
Termini long-tail
Finestre con offset
0,1 crediti per risultato
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 Suggestions

I suggerimenti di parole chiave sono termini di ricerca long-tail che contengono una parola o una frase di partenza con aggiunte prima, dopo o al suo interno, e i loro record possono includere segnali di domanda, costo, concorrenza, cronologia mensile e intento. Questi termini corrispondenti e le relative misurazioni supportano l’espansione delle query, la ricerca per i brief dei contenuti, l’analisi della ricerca a pagamento e il confronto controllato delle varianti di formulazione.

Funzionalità della Keyword Suggestions API

  • Espansione full-text della frase di partenzaRestituisce termini di ricerca che mantengono le parole di partenza inviate, ammettendo aggiunte prima, dopo o all’interno della frase e differenze nell’ordine delle parole.
  • Oggetti di misurazione delle parole chiaveConserva nei dati della fonte di ogni record, quando disponibili, volume di ricerca, CPC, concorrenza a pagamento, cronologia mensile e dettagli sulla difficoltà.
  • Contesto dell’intento di ricercaEspone, quando disponibili, le informazioni sull’intento primario e secondario di ogni parola chiave corrispondente, senza considerarle una raccomandazione di posizionamento.
  • Finestre di risultati controllateAccetta un tetto di risultati da 1 a 1.000 e un offset di riga a base zero per recuperare una finestra successiva della fonte.

Parametri della Keyword Suggestions API

ParametriObbligatorioDescrizione
queryObbligatorioParola chiave o frase di partenza obbligatoria e non vuota. Un’attività accetta una sola query.
location_codeFacoltativoCodice numerico positivo del mercato di ricerca. Il Playground usa per impostazione predefinita 2840.
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. 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_limitFacoltativoMassimo richiesto da 1 a 1.000 suggerimenti. Possono essere restituite meno righe.
offsetFacoltativoNumero a base zero di righe della fonte da saltare prima di raccogliere la finestra di risultati richiesta.

Come usare la Keyword Suggestions API

Invia una query di partenza con controlli di mercato e una finestra di risultati limitata, poi leggi ogni suggerimento dall’attività asincrona completata.

  1. Scegli una query non vuota, un location_code, un language_code, un results_limit da 1 a 1.000 e un offset pari o superiore a 0.
  2. Invia con POST il payload a /v1/seo/keyword-suggestions e 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 richiedi il next_cursor restituito finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/seo/keyword-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"keyword research","location_code":2840,"language_code":"en","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della Keyword Suggestions API

  • Espansione long-tail delle query: Usa una frase di partenza e il testo delle parole chiave restituite per raccogliere varianti di query più lunghe che mantengono le parole originali.
  • Ricerca di candidati per i brief dei contenuti: Combina i termini corrispondenti con i campi disponibili di volume, cronologia mensile, difficoltà e intento per assemblare un insieme di parole chiave da rivedere.
  • Confronto delle parole chiave della ricerca a pagamento: Confronta le misurazioni disponibili di CPC e concorrenza a pagamento tra varianti di formulazione prima di passare i candidati a un flusso di lavoro di pianificazione.

Consigli degli esperti per la Keyword Suggestions API

  • Usa una frase di partenza specifica quando ti servono varianti long-tail strettamente corrispondenti; scegli un endpoint di parole chiave semantico quando i termini non devono contenere le parole di partenza.
  • Considera offset come un conteggio di righe e non come un numero di pagina, e aumentalo della dimensione della finestra della fonte che vuoi saltare.
  • Registra insieme query, location_code, language_code, results_limit e offset, perché l’ordinamento successivo della fonte può cambiare tra richieste altrimenti corrispondenti.
  • Leggi prima keyword e search_intent dai campi normalizzati, poi esamina extra.keyword_info e extra.keyword_properties per gli oggetti di misurazione diretti che non sono promossi.
  • Elimina i duplicati delle finestre ripetute per parola chiave più mercato e lingua, e metti in conto che ogni metrica facoltativa o oggetto annidato possa mancare.

Oltre alla Keyword Suggestions 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.
  • 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.

Esplora altre piattaforme

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

Keyword Suggestions API — FAQ

Keyword Suggestions API è un’interfaccia programmatica per trovare termini di ricerca long-tail a partire da una query di partenza, un codice di mercato e un codice lingua. Restituisce parole chiave corrispondenti, dettagli disponibili su domanda e concorrenza, cronologia mensile, contesto dell’intento e righe complete della fonte.

I suggerimenti contengono le parole di partenza inviate con aggiunte prima, dopo o al loro interno, ma l’ordine delle parole può differire. Usa l’endpoint per l’espansione full-text e non per ampie alternative semantiche.

results_limit è un tetto da 1 a 1.000, mentre offset è il numero di righe precedenti della fonte da saltare. offset non è un numero di pagina e l’ordine della fonte può cambiare nel tempo.

I campi stabili di keyword e intento, se disponibili, sono normalizzati, mentre le misurazioni di ricerca dirette e le proprietà della parola chiave possono restare in extra.keyword_info e extra.keyword_properties. I client dovrebbero trattare ogni valore facoltativo come nullable.

Ogni suggerimento restituito costa 0,1 crediti SocQ. Un insieme di risultati vuoto non comporta addebiti sui risultati e results_limit fornisce la stima prima della richiesta, non un conteggio finale garantito.