Metodi keyword

I metodi keyword dell’API SISTRIX ti forniscono tutti i dati e le informazioni relative alle parole chiave: Ranking organici, annunci e risultati della Universal Search.

Grazie all’API si SISTRIX avrai a disposizione i dati di milioni di keyword. La regola fondamentale è di usare correttamente il parametro country- per ricevere i dati del Paese corretto.

Ricorda che l’API è disponibile a partire dal pacchetto Plus, grazie al quale avrai accesso ai dati per l’Indice di Visibilità. Acquistando il pacchetto Professional o Premium potrai invece utilizzare tutti i metodi dell’API di SISTRIX.

keyword

Questo metodo fornisce una panoramica degli ulteriori metodi disponibili per la relativa keyword. Oltre all’API Key, deve essere indicata anche la keyword di cui si necessitano i dati. Ti preghiamo di notare che questa è codificata come UTF-8 String. Non verranno addebitati crediti per l’uso di questo metodo.

Parametri richiesti: api_key, kw

https://api.sistrix.com/keyword?api_key=[API_KEY]&kw=automobile

keyword.seo

Questa richiesta permette di ottenere le informazioni sulle SERP delle relative keyword. Nel caso non venga inserito il parametro “date“, sarà fornito un elenco di possibili date per la query. Per questo elenco non verranno addebitati crediti.

Impostando parametro “date“, appariranno le SERP della data corrispondente. Oltre al formato comune della data (ISO 8601), il parametro “date” accetterà anche termini come “now” (settimana corrente) oppure “last week” (settimana passata).

Specificando il parametro “num“, si potranno limitare i risultati: ad esempio, con il valore “10”, verranno fornite soltanto le prime 10 posizioni. Con i parametri Domain o URL, si potranno limitare i risultati a specifici domini o URL. Per ogni posizione fornita verrà addebitato un credito.

Parametri richiesti: api_key, kw
Parametri facoltativi: date, num, domain, url

https://api.sistrix.com/keyword.seo?api_key=[API_KEY]&kw=automobile&date=now&num=20

keyword.seo.traffic

Questa richiesta API riporta il volume di ricerca di una keyword: per saperne di più su questa metrica leggi qui.

Oltre ai parametri “api_key” e “kw“, che ti serviranno per la keyword, potrai anche aggiungere il parametro “country” per selezionare il Paese a cui si devono riferire i dati del volume di ricerca.

Parametri richiesti: api_key, kw
Parametri facoltativi: country

https://api.sistrix.com/keyword.seo?api_key=[API_KEY]&kw=automobile

keyword.seo.serpfeatures

Effettua questa richiesta per ottenere tutte le SERP Features di una keyword. Le SERP Features sono tutti quegli elementi che formano le pagine dei risultati di Google.

SISTRIX monitora più di 40 diverse SERP Features: troverai una panoramica completa in questa pagina.

Oltre alle diverse SERP Features, questa richiesta API mostra anche quante volte una determinata Feature viene mostrata nella pagina dei risultati della keyword corrispondente.

Parametri richiesti: api_key, kw

https://api.sistrix.com/keyword.seo.serpfeatures?api_key=[API_KEY]&kw=automobile

keyword.seo.searchintent

L’intento di ricerca ti mostra lo scopo per il quale un utente effettua una ricerca. Questa richiesta API ti fornirà l’intento di ricerca stimato per una determinata keyword.

Per ogni intento di ricerca (Know, Know Simple, Visit, Website e Do) verrà riportato un valore tra 0 e 100. Maggiore sarà questo valore, più sarà soddisfatto l’intento di ricerca corrispondente. Per maggiori informazioni sugli intenti di ricerca puoi leggere questa pagina.

Parametri richiesti: api_key, kw

https://api.sistrix.com/keyword.seo.searchintent?api_key=[API_KEY]&kw=hotel+milano

keyword.sem

Riporta gli annunci AdWords della keyword. Se il metodo verrà richiesto senza specificare il parametro “date“, sarà fornito un elenco di possibili date per la query. Per questo elenco non verranno addebitati crediti.

Inserendo parametro “date“, verranno mostrate le Ads della data corrispondente. Oltre al formato comune della data (ISO 8601), il parametro “date” accetterà anche termini come “now” (settimana corrente) oppure “last week” (settimana passata).

Specificando il parametro “num“, si potrà limitare la quantità di risultati: ad esempio, con il valore “3”, verranno forniti soltanto i primi 3 annunci. Con i parametri Domain o URL, si potranno limitare i risultati a specifici domini o URL. Per ogni annuncio fornito verrà addebitato un credito.

Parametri richiesti: api_key, kw
Parametri facoltativi: date, num, domain

https://api.sistrix.com/keyword.sem?api_key=[API_KEY]&kw=automobile&date=now&num=3

keyword.us

Questo metodo fornisce le integrazioni Universal Search all’interno delle SERP. Se il metodo verrà richiesto senza specificare il parametro “date“, sarà fornito un elenco di possibili date per la query. Per questo elenco non verranno addebitati crediti.

Inserendo il parametro “date“, appariranno i risultati della data corrispondente. Oltre al formato comune della data (ISO 8601), il parametro “date” accetterà anche termini come “now” (settimana corrente) oppure “last week” (settimana passata).

I dati relativi alle integrazioni della Universal Search verranno ordinati in base alla tabella in appendice. Il valore “position” riguarda il posizionamento del box Universal Search, mentre il valore “position.intern” indica il posizionamento dell’URL corrispondente all’interno del box.

Parametri richiesti: api_key, kw
Parametri facoltativi: date

https://api.sistrix.com/keyword.us?api_key=[API_KEY]&kw=angela+merkel&date=now

keyword.domain.seo

Con questo metodo verranno mostrate le keyword di un dominio trovate all’interno dei Ranking organici di Google. Se il metodo verrà richiesto senza specificare il parametro “date“, sarà fornito un elenco di possibili date per la query. Per questo elenco non verranno addebitati crediti.

Inserendo parametro “date“, appariranno i risultati della data corrispondente. Oltre al formato comune della data (ISO 8601), il parametro “date” accetterà anche termini come “now” (settimana corrente) oppure “last week” (settimana passata). Specificando il parametro “num“, potrai limitare la quantità di keyword che desideri ottenere. Verrà addebitato un credito per ogni keyword fornita.

Inserendo un termine di ricerca nel parametro “search“, le keyword verranno filtrate, permettendoti di ottenere solo quelle contenenti quel termine. Indicando il parametro “host” otterrai solo le keyword di uno specifico nome host del dominio. Allo stesso modo, il parametro “url” limiterà la ricerca di keyword ad un specifico URL del dominio, mentre il parametro “path” ad una specifica directory nel dominio.

I parametri “from_pos” e “to_pos” permetteranno di selezionare le keyword in base alla loro posizione, all’interno degli estremi specificati. Il parametro “extended” recupererà i dati dal database esteso.

Parametri richiesti: api_key, domain
Parametri facoltativi: date, num, search, host, url, path, from_pos, to_pos, extended

https://api.sistrix.com/keyword.domain.seo?api_key=[API_KEY]&domain=sistrix.com&date=now&host=www.sistrix.com

keyword.domain.sem

Mostra le keyword per le quali sono stati trovati annunci AdWords per il domino corrispondente. Se il metodo verrà richiesto senza specificare il parametro “date“, sarà fornito un elenco di possibili date per la query. Per questo elenco non verranno addebitati crediti.

Se parametro “date” verrà inserito, appariranno le Ads della data corrispondente. Oltre al formato comune della data (ISO 8601), il parametro “date” accetterà anche termini come “now” (settimana corrente) oppure “last week” (settimana passata). Specificando il parametro “num“, si potranno limitare i risultati. Per ogni keyword riportata verrà addebitato un credito.

Inserendo un termine di ricerca nel parametro “search“, le keyword verranno filtrate, permettendoti di ottenere solo quelle contenenti quel termine. Il parametro “extended” recupererà dati dal database esteso.

Parametri richiesti: api_key, domain
Parametri facoltativi: date, num, search, extended

https://api.sistrix.com/keyword.domain.sem?api_key=[API_KEY]&domain=sistrix.com&date=now&search=automobile&num=20

keyword.domain.us

Questo metodo mostra le keyword per le quali il dominio compare nelle integrazioni Universal Search di Google. Se il metodo verrà richiesto senza specificare il parametro “date“, sarà fornito un elenco di possibili date per la query. Per questo elenco non verranno addebitati crediti.

Inserendo il parametro “date“, appariranno le Ads della data corrispondente. Oltre al formato comune della data (ISO 8601), il parametro “date” accetterà anche termini come “now” (settimana corrente) oppure “last week” (settimana passata). Specificando il parametro “num“, si potranno limitare i risultati. Per ogni keyword riportata verrà addebitato un credito.

Inserendo un termine di ricerca nel parametro “search“, le keyword verranno filtrate, permettendoti di ottenere solo quelle contenenti quel termine. Il parametro “host” limiterà la ricerca di keyword a uno specifico nome host del dominio. Verrà addebitato un credito per ogni keyword riportata. I dati relativi alle integrazioni della Universal Search verranno ordinati in base alla tabella in appendice. Il valore “position” riguarda il posizionamento del box Universal Search, mentre il valore “position.intern” indica il posizionamento dell’URL corrispondente all’interno del box. Il parametro “extended” recupererà dati dal database esteso.

Parametri richiesti: api_key, domain
Parametri facoltativi: date, num, search, host, extended

https://api.sistrix.com/keyword.domain.us?api_key=[API_KEY]&domain=sistrix.com&date=now&num=20

Appendice

Ordine dei dati per la richiesta keyword.domain.us
“type”Descrizione
1shopping
2notizie
3blog
4immagini
5video
6mappe
23.08.2021