Le richieste API legate ai metodi Optimizer non consumano generalmente nessun credito del tuo account del Toolbox.
optimizer.projects
Questo metodo fornisce l’ID del progetto e i nomi dei progetti esistenti nell’Optimizer. Non verranno addebitati crediti per questa richiesta.
Parametro richiesto: api_key
https://api.sistrix.com/optimizer.projects?api_key=[API_KEY]
optimizer.project
Questo metodo fornisce le informazioni riguardo ad un progetto Optimizer e ai tag esistenti. Qui l’hash del progetto (che può essere richiesto tramite il metodo optimizer.projects) verrà riportato nel parametro “project”.
Parametro richiesto: api_key, project
https://api.sistrix.com/optimizer.project?api_key=[API_KEY]&project=[PROJECT]
optimizer.ranking
Questo metodo riporta le keyword e i Ranking esistenti per un progetto Optimizer. L’ID del progetto verrà inserito nel parametro “project“. Tramite il parametro “limit” sarà invece possibile ridurre la quantità dei risultati (di default ne verranno riportati 100); grazie al parametro “tag” potrai filtrare le keyword in base a un tag esistente.
Questa richiesta permetterà inoltre di ottenere numerose informazioni aggiuntive relative al dispositivo, motore di ricerca e Paese selezionati. I tag verranno separati dal simbolo “|”.
Parametro richiesto: api_key, project
Parametro facoltativo: limit, offset, tag
https://api.sistrix.com/optimizer.ranking?api_key=[API_KEY]&project=[PROJECT]
optimizer.visibility
Questo metodo riporta la visibilità del progetto Optimizer. L’ID del progetto verrà inserito nel parametro “project“. Tramite il parametro “date” sarà possibile ottenere un valore passato, mentre grazie a “tag” potrai filtrare l’Indice di Visibilità del progetto in base ai tag. Impostando il parametro “competitors” su “true” potrai avere una panoramica dei concorrenti selezionati nel progetto.
Parametro richiesto: api_key, project
Parametro facoltativo: date, tag, competitors
https://api.sistrix.com/optimizer.visibility?api_key=[API_KEY]&project=[PROJECT]
optimizer.keyword.serps
Questo metodo fornisce le SERP per le keyword inserite nel progetto Optimizer. L’ID del progetto verrà inserito nel parametro “project“. Potrai anche delineare meglio la tua ricerca in base a Paese, città, tipo di dispositivo e motore di ricerca. Si tratta di una funzione utile nel caso in cui tu possieda più di una keyword con lo stesso nome: senza i filtri precedenti, l’API fornirà di default la prima keyword trovata.
Potrai anche usare il parametro “date” per richiedere dei dati passati e “num” per limitare la quantità dei risultati che desideri ottenere.
Parametro richiesto: api_key, project, kw
Parametro facoltativo: country, city, device, searchengine, date, num
https://api.sistrix.com/optimizer.keyword.serps?api_key=[API_KEY]&project=[PROJECT]&kw=[KEYWORD]
optimizer.onpage.overview
Questo metodo fornisce tutti i dati disponibili relativamente alla scansione Onpage: tra questi, l’orario, il numero di pagine scansionate, gli errori, gli avvertimenti e gli avvisi.
Parametro richiesto: api_key, project
https://api.sistrix.com/optimizer.onpage.overview?api_key=[API_KEY]&project=[PROJECT]optimizer.onpage.crawl
Questo metodo fornisce tutti i risultati di una specifica scansione Onpage. Usa il parametro “date” per ottenere i dati di un crawling passato. Troverai tutte le date possibili tramite la richiesta: optimizer.onpage.overview.
Parametro richiesto: api_key, project
Parametro facoltativo: date
https://api.sistrix.com/optimizer.onpage.crawl?api_key=[API_KEY]&project=[PROJECT]optimizer.onpage.issue
Questo metodo fornisce risultati dettagliati per una specifica scansione Onpage. Potrai usare il parametro “issue” per ottenere dei singoli valori riguardanti dei dati emersi tramite la richiesta optimizer.onpage.crawl. Usando il parametro “date“, potrai accedere ai risultati delle scansioni precedenti.
Parametro richiesto: api_key, project, issue
Parametro facoltativo: date, limit, offset
https://api.sistrix.com/optimizer.onpage.issue?api_key=[API_KEY]&project=[PROJECT]&issue=[ISSUE]optimizer.start.onpage.check
Con questo metodo potrai avviare una scansione Onpage di un progetto Optimizer direttamente via API, e il processo seguirà esattamente quello manuale del frontend di SISTRIX. Le richieste URL utilizzate per questo metodo vengono detratte dalla quota di crediti totali dell’account.
Parametro richiesto: api_key, project
https://api.sistrix.com/optimizer.start.onpage.check?project=[PROJECT]&api_key=[API_KEY]optimizer.competitors
Con questo metodo potrai estrapolare i concorrenti di un dominio sulla base di un campione di keyword personale. Oltre al nome del dominio verrà anche riportato il grado di congruenza (0-100). Utilizzando il parametro “num” potrai ridurre la quantità di domini riportati, che sarebbe altrimenti di 100 risultati.
Parametro richiesto: api_key, project
Parametro opzionale: num
https://api.sistrix.com/optimizer.competitors?api_key=[API_KEY]&project=[PROJECT]optimizer.project.urls
Questo metodo riporta le pagine HTML scansionate del progetto, riferendosi alla tabella “URL” (nella sezione “Onpage” > “Modalità esperto”) del frontend di SISTRIX. Oltre all’URL verranno riportati anche altri dettagli della tabella (ad esempio la dimensione del file, il tag title e altri elementi).
Parametro richiesto: api_key, project
https://api.sistrix.com/optimizer.project.urls?api_key=[API_KEY]&project=[PROJECT]optimizer.project.links
Questo metodo riporta i link sia interni, sia esterni del progetto trovati dal crawler. Esso rispecchia quindi la tabella “Link” della sezione “Onpage” > “Modalità esperto” del frontend di SISTRIX.
Parametro richiesto: api_key, project
https://api.sistrix.com/optimizer.project.links?api_key=[API_KEY]&project=[PROJECT]optimizer.project.resources
Questo metodo riporta tutte le risorse trovate per il progetto (immagini, file Javascript e/o CSS), riferendosi quindi alla tabella “Risorse” della sezione “Onpage” > “Modalità esperto” del Toolbox.
Parametro richiesto: api_key, project
https://api.sistrix.com/optimizer.project.resources?api_key=[API_KEY]&project=[PROJECT]optimizer.project.resources.usage
Questo metodo riporta tutte le risorse trovate ed effettivamente in uso, riferendosi quindi alla tabella “Totale risorse” della sezione “Onpage” > “Modalità esperto”.
Parametro richiesto: api_key, project
https://api.sistrix.com/optimizer.project.resources.usage?api_key=[API_KEY]&project=[PROJECT]optimizer.project.cookies
Questo metodo ti mostra i cookie usati nel progetto scansionato: il crawler di SISTRIX raccoglie tutti i cookie che il server web vorrebbe impostare, salvandoli, ma senza utilizzarli. Si tratta quindi della tabella “Cookie” della sezione “Onpage” > “Modalità esperto”.
Parametro richiesto: api_key, project
https://api.sistrix.com/optimizer.project.cookies?api_key=[API_KEY]&project=[PROJECT]optimizer.create.onpage.project
Questo metodo permette di creare un progetto Onpage con keyword al suo interno. Per la creazione vengono considerati i limiti dell’account.
Il parametro crawl_limit può essere utilizzato per specificare il numero massimo di pagine in un progetto. È possibile selezionare un massimo di 25.000 pagine tramite l’API.
Il nome del progetto può essere impostato con il parametro project_name, altrimenti verrà considerato l’ambito del progetto.
frequency definisce la frequenza di scansione del progetto. Per impostazione predefinita, viene impostata una scansione settimanale; il valore “manuale” è facoltativo. La frequenza di scansione riguarda solo il progetto Onpage, non le keyword.
È possibile aggiungere fino a 40 parole chiave tramite keywords . Il trasferimento all’API avviene in formato JSON.
Parametri richiesti: api_key; domain, host, path o url
Parametri facoltativi: acknowledge_extra_cost, crawl_limit, project_name, frequency, keywords
https://api.sistrix.com/optimizer.create.onpage.project?api_key=[API_KEY]&domain=sistrix.it
