Related Keywords
Le parole chiave correlate sono query collegate tramite il grafo delle ricerche correlate, con segnali di profondità, domanda, CPC, concorrenza, difficoltà e intento. Queste relazioni e misurazioni supportano la scoperta di argomenti adiacenti, l’espansione delle mappe tematiche e il confronto tra candidati.
Funzionalità della Related Keywords API
- Espansione del grafo delle ricerche correlateSegue le relazioni dirette o ricorsive tra query a partire da una parola chiave di partenza, con valori di profondità da 0 a 4, senza richiedere che la frase sia contenuta.
- Oggetti di misurazione delle parole chiaveRestituisce, per ogni query collegata, volume di ricerca, CPC, concorrenza a pagamento, cronologia mensile, difficoltà e informazioni sull’intento, quando disponibili.
- Contesto della relazione conservatoMantiene in extra profondità della fonte, percorsi delle parole chiave correlate, keyword_data completo e altri campi variabili per un’interpretazione dettagliata del grafo.
Parametri della Related Keywords 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 facoltativo del mercato di ricerca. |
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. |
language | Facoltativo | Nome facoltativo della lingua di ricerca, alternativo a language_code. Se compilato, ha la precedenza su language_code. |
depth | Facoltativo | Profondità della relazione da 0 a 4. Il valore predefinito 1 restituisce le query collegate direttamente. |
results_limit | Facoltativo | Massimo richiesto da 1 a 1.000 parole chiave correlate. 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 Related Keywords API
Invia una query di partenza con una profondità di relazione, controlli di mercato e una finestra di risultati limitata, poi leggi i record correlati dall’attività asincrona completata.
- Scegli una query non vuota, un location_code, un language_code, una depth da 0 a 4, un results_limit da 1 a 1.000 e un offset pari o superiore a 0.
- Invia con POST il payload a /v1/seo/related-keywords 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/related-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"keyword research","depth":1,"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 Related Keywords API
- Scoperta di argomenti adiacenti: Usa il testo delle query restituite e il contesto della relazione per trovare argomenti collegati che non devono contenere la frase di partenza.
- Espansione della mappa tematica: Confronta la profondità e i percorsi delle parole chiave correlate per estendere una parola chiave di partenza dai vicini diretti a un grafo di query più ampio.
- Valutazione dei candidati di parole chiave: Combina i termini correlati con domanda, costo, concorrenza, difficoltà, cronologia mensile e intento disponibili per preparare un insieme di candidati da rivedere.
Consigli degli esperti per la Related Keywords API
- Parti da depth 1 per le relazioni dirette; aumenta la profondità solo quando un grafo più ampio vale l’insieme di candidati più grande e potenzialmente meno diretto.
- Usa invece Keyword Suggestions quando ogni termine restituito deve mantenere le parole di partenza, perché le query correlate possono usare formulazioni diverse.
- Mantieni fissi query, location_code, language_code e depth quando confronti finestre di risultati, così il contesto di relazione e di mercato resta confrontabile.
- Considera offset come un conteggio di righe e non come un numero di pagina, e aumentalo del numero di righe della fonte che vuoi saltare.
- Leggi prima keyword, metrics, monthly_searches e search_intent dai campi normalizzati, poi esamina extra per profondità della fonte e percorsi delle relazioni.
- Non dedurre un intento identico dalla vicinanza nel grafo e metti in conto che misurazioni facoltative e campi extra variabili possano mancare.
API correlate
Oltre alla Related Keywords 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.
- 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.
- 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.
- Keywords for Site 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