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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
target | Obbligatorio | Destinazione 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_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 righe di parole chiave posizionate. 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 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.
- 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.
- Invia con POST il payload a /v1/seo/ranked-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/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 trueCasi 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.
API correlate
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.
- Keyword Suggestions API
- Related Keywords 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