seo/
related-keywords

Scopri le query collegate a una parola chiave di partenza tramite percorsi di ricerche correlate, con metriche delle parole chiave, domanda mensile, intento e profondità della relazione in record normalizzati.

Related Keywords API

Grafo delle ricerche correlate
Controllo della profondità
Misurazioni delle parole chiave
0,1 crediti per risultato
Pronto
README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
queryObbligatorioParola chiave o frase di partenza obbligatoria e non vuota. Un’attività accetta una sola query.
location_codeFacoltativoCodice numerico positivo facoltativo del mercato di ricerca.
location_nameFacoltativoNome facoltativo del mercato di ricerca, alternativo a location_code. Se compilato, ha la precedenza su location_code.
language_codeFacoltativoCodice facoltativo della lingua di ricerca, da 2 a 10 caratteri.
languageFacoltativoNome facoltativo della lingua di ricerca, alternativo a language_code. Se compilato, ha la precedenza su language_code.
depthFacoltativoProfondità della relazione da 0 a 4. Il valore predefinito 1 restituisce le query collegate direttamente.
results_limitFacoltativoMassimo richiesto da 1 a 1.000 parole chiave correlate. 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 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.

  1. 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.
  2. Invia con POST il payload a /v1/seo/related-keywords 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/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 true

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

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.

Esplora altre piattaforme

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

Related Keywords API — FAQ

Related Keywords API è un’interfaccia programmatica per trovare le query collegate a una parola chiave di partenza tramite il grafo delle ricerche correlate di un mercato di ricerca selezionato. Restituisce testo delle parole chiave, misurazioni disponibili, cronologia mensile, informazioni sull’intento, profondità della relazione e righe complete della fonte.

depth accetta da 0 a 4: 0 rappresenta la parola chiave di partenza inviata, 1 copre le relazioni dirette e i valori più alti espandono in modo ricorsivo. Profondità maggiori possono produrre un insieme di candidati più ampio e meno direttamente correlato.

No. Le connessioni delle ricerche correlate possono restituire formulazioni diverse, quindi usa Keyword Suggestions quando servono varianti long-tail che contengano la frase.

I record normalizzati possono includere testo della parola chiave, volume di ricerca, CPC, concorrenza a pagamento, difficoltà della parola chiave, ricerche mensili e informazioni sull’intento. Profondità della relazione nella fonte, percorsi correlati e l’intero oggetto keyword_data restano in extra.

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 la fonte può restituire meno righe di quelle richieste.

Ogni parola chiave correlata restituita 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.