L'interfaccia di programmazione di una applicazione (API, Application Programming Interface) è un metodo per estrarre i dati grezzi di Semrush senza accedere manualmente al software. Semrush offre due opzioni API principali:
- Pacchetto API standard (API Analisi e Progetti)
- API di Traffic Analytics
Questa API è disponibile come add-on per un piano Business. Il pacchetto API standard contiene le API Analisi e Progetti. Passare al piano Business ti permetterà di acquistare unità API e di generare una chiave API. Nota bene: dopo essere passato al piano Business, il numero di unità sarà ancora zero. Dovrai acquistare un numero adeguato di unità API in base alle tue necessità. Se nel tuo piano di abbonamento è incluso un determinato numero di unità fin dall'inizio, nel caso in cui l'abbonamento venisse interrotto queste unità verranno perdute.
Se rimani a corto di unità puoi comprarne altre dalla pagina Dati di abbonamento o contattandoci.
Scopri come ottenere un'API qui.
- L'API Analisi ti permette di estrarre dati dai report di Analisi, inclusi:
- L'API Progetti può estrarre i dati dalle campagne di Tracking della posizione e Site Audit create in Progetti.
È possibile ottenere i dati di sottocartelle e sottodomini tramite API. Consultate la sezione Sottodominio e sottocartella nella Documentazione API per vedere da quali report è possibile estrarre i dati.
Le chiamate delle API Analisi e Progetti hanno un costo in unità API. La quantità totale di unità che dovrai spendere dipenderà dal tipi di richiesta o dal numero esatto di righe del report.
Puoi verificare il saldo delle unità API o nella scheda Dati di abbonamento o tramite una richiesta API gratuita (Saldo unità API).
Puoi vedere l'elenco completo dei report Semrush che l'API può estrarre qui. Troverai la tua chiave API nella pagina Dati di abbonamento.
L'API di Traffic Analytics è disponibile solo per gli utenti di Semrush con un piano a pagamento ed è disponibile in due piani:
- Base: fornisce solo dati di riepilogo sul traffico
- Esteso: fornisce dati di riepilogo sul traffico e 8 report distinti
API base
I dati di Panoramica traffico potranno mostrarti le stime relative al comportamento dei visitatori su un sito. Tra le metriche stimate troverai visite mensili, visite uniche, pagine per visita, durata media della visita, % di traffico desktop e mobile e frequenza di rimbalzo.
Allo stesso modo, il report Panoramica di Traffic Analytics può confrontare fino a 5 domini alla volta e puoi estrarre questi dati per fino a 200 domini con una singola richiesta usando i report di riepilogo. Questi dati ti permettono di dare una rapida occhiata al livello generale di interazione tra un sito web e i suoi visitatori.
Le chiamate API di Traffic Analytics funzionano per i domini principali, i sottodomini e le sottocartelle, tranne che per Domain Rankings, Audience Insights e Data Accuracy.
API estesa
L'API estesa (dettagli completi nella documentazione dell'API) offre 8 report distinti, oltre a Panoramica traffico dell'API base:
- Fonti di traffico: uno spaccato del traffico del sito suddiviso in diretto, referral, ricerca, social e a pagamento;
- Destinazioni del traffico: dove vanno gli utenti dopo aver visitato il dominio che stai analizzando;
- Distribuzione geografica: i paesi, le regioni o i subcontinenti da cui un sito web riceve più visitatori;
- Sottodomini: i sottodomini del sito web che ottengono la maggior parte del traffico;
- Pagine principali: il numero di visualizzazioni uniche, di visitatori unici, di accessi e le fonti di traffico di fino a 1000 delle migliori pagine di un sito in base al traffico;
- Ranking del dominio: principali siti web nel luogo target nel periodo target ordinati in base al traffico;
- Informazioni sul pubblico: altri domini visitati, pubblico unico, percentuale di pubblico condiviso e pubblico condiviso per i domini analizzati;
- Precisione dei dati: la precisione stimata del report in base alle dimensioni del dominio e ai filtri che hai applicato (dati storici, luogo, dispositivo).
Il limite mensile incluso di default è di 10.000 richieste. Quest'API non usa le unità API associate con il pacchetto API Semrush standard per i piani Business.
Se sei interessato alla nostra API Traffic Analytics puoi accedervi tramite la pagina "Dati di abbonamento".
In alternativa, puoi contattarci all'indirizzo sales@semrush.com e ti invieremo un preventivo adatto alle tue esigenze.
Per acquistare l'API Traffic Analytics dovrai avere un piano di Semrush a pagamento. Puoi acquistare l'accesso all'API da solo o tramite i nostri rappresentanti commerciali e poi ricevere la tua chiave API via e-mail.
Le pagine Documentazione API sottostanti saranno fondamentali per lavorare con l'API, visto che al loro interno contengono spiegazioni dettagliate per ogni singola chiamata. Verrà mostrata anche la formattazione corretta, in modo che tu possa strutturare in modo adeguato le tue chiamate API. Queste chiamate possono essere fatte incollando la tua chiamata API in un browser web.
Se hai bisogno di aiuto con l'API, usa i seguenti link alla documentazione:
- Sommario API
- Termini di servizio API
- API Analisi (Analisi dominio, Analisi keyword, Backlink, ecc.)
- API Progetti (Tracking della posizione, Site Audit)
- Saldo delle unità API
- Documentazione sull'API Traffic Analytics
Nota bene: nella sezione 2.3 dei nostri Termini di servizio ti chiediamo di non inviare più di 10 richieste al secondo alla nostra API:
Abbonandoti all'API Semrush accetti, oltre alle restrizioni indicate sopra: (i) di non inviare più di 10 richieste ogni 1 secondo da un unico indirizzo IP o più di 10 richieste contemporaneamente da 1 utente; e (ii) di non conservare nella cache le informazioni ricevute dai Servizi per più di un (1) mese senza esplicito consenso scritto da parte di Semrush. Non puoi usare i Servizi se non ti è legalmente consentito ricevere o usare i Servizi ai sensi delle leggi del paese in cui risiedi o da cui accedi o dove utilizzi i Servizi.
Consulta il nostro post del blog Che cos'è un'API e in che modo posso usarla? per apprendere le informazioni fondamentali sulle API e in che modo possono esserti utili.