seo/
ranked-keywords

Trova le parole chiave per cui un dominio, un sottodominio o una pagina si posiziona in un mercato di ricerca, con URL, posizioni, metriche di ricerca, intento e contesto del traffico stimato.

Ranked Keywords API

Destinazione dominio o pagina
Mappatura degli URL in classifica
Contesto della posizione
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

Ranked Keywords

Le parole chiave posizionate sono query di ricerca collegate a un dominio, un sottodominio o una pagina tramite l’URL di un risultato corrispondente, con posizioni di gruppo, assolute e di pagina dei risultati più i segnali disponibili di domanda, difficoltà, intento e traffico. Queste relazioni tra query e pagine supportano gli inventari della visibilità, la mappatura delle landing page, la revisione delle opportunità e il confronto tra istantanee di destinazioni.

Funzionalità della Ranked Keywords API

  • Ambito di dominio, sottodominio o paginaRisolve una destinazione web formattata correttamente con l’ampiezza necessaria per un intero dominio, un sottodominio o l’URL completo di una pagina.
  • Relazioni tra parole chiave e URLAbbina ogni parola chiave restituita all’URL di destinazione corrispondente esposto dal suo elemento in classifica nei risultati di ricerca.
  • Posizioni e misurazioni delle parole chiaveRestituisce le posizioni di gruppo, assolute e di pagina dei risultati disponibili insieme a volume di ricerca, CPC, concorrenza, difficoltà, cronologia mensile e intento.
  • Elemento corrispondente completoConserva keyword_data e ranked_serp_element in extra, così tipo di risultato, traffico modellato e dettagli della fonte non promossi restano disponibili.

Parametri della Ranked Keywords API

ParametriObbligatorioDescrizione
targetObbligatorioDestinazione obbligatoria di dominio, sottodominio o pagina. Ometti https:// e www. per un dominio, ometti il protocollo per un sottodominio, oppure usa un URL completo per una singola pagina.
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 righe di parole chiave posizionate. 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 Ranked Keywords API

Invia una destinazione con l’ambito corretto, controlli di mercato e una finestra di risultati limitata, poi leggi ogni parola chiave posizionata dall’attività asincrona completata.

  1. Scegli una destinazione, 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/ranked-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/ranked-keywords" \
  -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 Ranked Keywords API

  • Inventario della visibilità organica: Usa il testo delle parole chiave restituite e gli URL corrispondenti per catalogare dove compare un dominio o un sottodominio nel mercato di ricerca selezionato.
  • Mappa del posizionamento delle landing page: Combina ogni parola chiave, URL di destinazione e oggetto rank per individuare quale pagina è associata a ciascuna posizione restituita.
  • Revisione delle opportunità di parole chiave: Confronta la posizione con i campi disponibili di volume, CPC, concorrenza, difficoltà e intento per assemblare una coda di revisione.
  • Confronto delle istantanee di visibilità: Salva input di destinazione corrispondenti, collected_at, parole chiave, URL e posizioni da attività ripetute per confrontare istantanee raccolte separatamente.

Consigli degli esperti per la Ranked Keywords API

  • Rimuovi https:// e www. da una destinazione di dominio e rimuovi il protocollo da una destinazione di sottodominio, così l’ambito voluto viene interpretato correttamente.
  • Usa un URL di pagina completo quando servono risultati a livello di pagina; un percorso di pagina senza protocollo può essere interpretato come destinazione dell’intero dominio.
  • Aumenta offset del numero di righe della fonte che vuoi saltare e mantieni fissi destinazione, mercato, lingua e limite quando recuperi finestre consecutive.
  • Considera rank.page come numero della pagina dei risultati di ricerca; usa offset per le finestre della fonte e next_cursor a parte per le pagine dei risultati salvati di SocQ.
  • Leggi prima le posizioni e le metriche delle parole chiave normalizzate, poi esamina extra.ranked_serp_element per etv modellato e gli altri campi della fonte non promossi.
  • Costruisci confronti storici da attività ripetute ed elimina i duplicati delle finestre per parola chiave, URL corrispondente, mercato e lingua, perché l’ordine della fonte può cambiare.

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

Ranked Keywords API — FAQ

Ranked Keywords API è un’interfaccia programmatica per trovare i termini di ricerca associati a un dominio, un sottodominio o una pagina in un mercato e in una lingua selezionati. Restituisce URL corrispondenti, posizioni, misurazioni delle parole chiave, cronologia mensile, intento ed elementi completi della fonte.

Usa un dominio semplice senza https:// né www., un sottodominio senza il protocollo oppure un URL completo per una singola pagina. Se indichi un percorso di pagina senza protocollo, l’ambito può estendersi all’intero dominio.

No. Le posizioni descrivono l’indice di ricerca e il mercato selezionati e non un risultato in tempo reale identico per ogni utente, quindi usa collected_at quando confronti istantanee ripetute.

rank.page è il numero della pagina dei risultati di ricerca, offset salta le righe di parole chiave della fonte e next_cursor scorre i risultati già salvati per l’attività SocQ. Questi valori non sono intercambiabili.

No. etv è un valore modellato conservato in extra.ranked_serp_element, non un’analisi privata del traffico o delle conversioni della destinazione.

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