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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Parola chiave o frase di partenza obbligatoria e non vuota. Un’attività accetta una sola query. |
location_code | Facoltativo | Codice numerico positivo del mercato di ricerca. Il Playground usa per impostazione predefinita 2840. |
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. 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 | Massimo richiesto da 1 a 1.000 suggerimenti. Possono essere restituite meno righe. |
offset | Facoltativo | Numero 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.
- 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.
- Invia con POST il payload a /v1/seo/keyword-suggestions e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
- 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 trueCasi 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.
API correlate
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.
- Ranked 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