seo/
keywords-for-site

Genera idee di parole chiave rilevanti per il dominio di un sito web, con volume di ricerca, CPC, concorrenza a pagamento, ricerche mensili e contesto completo in record normalizzati.

Keywords for Site API

Pertinenza del dominio
Metriche di domanda delle parole chiave
Record di parole chiave normalizzati
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

Keywords for Site

I record di Keywords for Site collegano l’argomento di un sito web a termini di ricerca rilevanti, volume di ricerca, CPC, concorrenza a pagamento, domanda mensile e contesto di categoria. Queste relazioni tra parole chiave e metriche supportano la scoperta di argomenti, la ricerca sui concorrenti, la creazione di elenchi di candidati e il confronto tra domini.

Funzionalità della Keywords for Site API

  • Scoperta della pertinenza basata sul dominioUsa il dominio di un sito web per recuperare idee di parole chiave associate al suo argomento, invece di partire da una frase di partenza.
  • Metriche di domanda e ricerca a pagamentoValuta ogni parola chiave restituita tramite volume di ricerca, CPC, concorrenza a pagamento, livello di concorrenza e osservazioni mensili di ricerca normalizzati.
  • Contesto completo delle parole chiaveEsamina extra per la riga completa restituita, dove restano accessibili categorie facoltative, difficoltà, intento, campi di tendenza e altri attributi non promossi.

Parametri della Keywords for Site API

ParametriObbligatorioDescrizione
targetObbligatorioDominio del sito web obbligatorio usato come fonte dell’argomento. Il Playground usa per impostazione predefinita microsoft.com.
location_codeFacoltativoCodice di località del mercato di ricerca, positivo e facoltativo. Il Playground invia 2840 per impostazione predefinita.
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. Il Playground invia en per impostazione predefinita.
languageFacoltativoNome facoltativo della lingua di ricerca, alternativo a language_code. Se compilato, ha la precedenza su language_code.
results_limitFacoltativoTetto richiesto dei risultati della fonte da 1 a 1.000. Il Playground invia 5 per coincidere con l’esempio della documentazione; il backend usa 100 quando il campo è omesso.

Come usare la Keywords for Site API

Invia un dominio con impostazioni di mercato, lingua e limite dei risultati, poi leggi i record di parole chiave normalizzati dall’attività completata.

  1. Scegli un dominio di destinazione, un location_code positivo, un language_code e un results_limit da 1 a 1.000.
  2. Invia con POST il payload a /v1/seo/keywords-for-site 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 segui next_cursor finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/seo/keywords-for-site" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'

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

Casi d’uso della Keywords for Site API

  • Scoperta degli argomenti di un sito web: Usa le parole chiave e le categorie restituite per individuare i temi di ricerca associati a un sito web noto.
  • Ricerca delle parole chiave dei concorrenti: Invia il dominio di un concorrente e combina i termini rilevanti con volume di ricerca, CPC e concorrenza a pagamento per assemblare un insieme di ricerca.
  • Confronto degli argomenti tra domini: Esegui separatamente i siti web di destinazione e confronta gli insiemi di parole chiave, le categorie e le metriche di domanda restituiti.

Consigli degli esperti per la Keywords for Site API

  • Rimuovi http:// e https:// da target prima di inviare il dominio, per evitare un formato di destinazione non valido.
  • Imposta mercato e lingua in modo esplicito quando confronti più esecuzioni, invece di affidarti al comportamento del provider per i campi omessi.
  • Scegli come results_limit il più grande insieme di risultati singolo utile, perché questo endpoint non ha un offset per richiedere una finestra successiva.
  • Tratta le metriche mancanti come non disponibili e non come zero, ed esamina extra quando un attributo necessario non è presente nei campi normalizzati.
  • Usa invece Ranked Keywords quando l’attività richiede posizioni osservate o URL in classifica anziché idee di parole chiave basate sulla pertinenza.

Oltre alla Keywords for Site 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.
  • Ranked Keywords API — Trova le parole chiave per cui si posizionano un dominio, un sottodominio o una pagina, con URL corrispondenti, posizioni, misurazioni di ricerca, intento ed elementi di origine completi.
  • Relevant Pages API — Fa l’inventario delle pagine indicizzate di un dominio con distribuzioni di posizionamento organico e a pagamento, traffico stimato dal modello e contesto dei costi stimati.

Esplora altre piattaforme

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

Keywords for Site API — FAQ

Keywords for Site API è un’interfaccia programmatica per generare idee di parole chiave da un dominio di sito web. Restituisce parole chiave normalizzate con volume di ricerca, CPC, concorrenza a pagamento, ricerche mensili e contesto completo restituito; la pertinenza non stabilisce un posizionamento.

Invia un solo dominio, come example.com, senza http:// né https://. L’endpoint accetta un solo sito web di destinazione per attività.

No. I termini restituiti sono candidati per pertinenza, non la prova che il sito si posizioni per essi. Usa Ranked Keywords quando servono posizioni e URL corrispondenti.

No. results_limit accetta da 1 a 1.000 e imposta il massimo di righe per un’attività, ma l’input pubblico non ha un offset per richiedere una finestra successiva.

Ogni parola chiave restituita costa 0,1 crediti SocQ. Un’attività senza righe restituite non comporta addebiti sui risultati.