L'API di Ranktracker è ora disponibile — Accesso incluso in ogni piano

Introduzione

L'API di Ranktracker è ufficialmente attiva.

Ogni piano Ranktracker ora include l'accesso all'API, offrendo ai clienti un modo diretto per collegare Ranktracker alle proprie dashboard, piattaforme di reportistica, sistemi interni e flussi di lavoro SEO.

Non è più necessario un abbonamento API separato o un account riservato alle aziende per iniziare a sviluppare. Che tu stia utilizzando il piano Launch, Growth, Scale o Authority, puoi creare una chiave API e lavorare a livello di programmazione con i dati disponibili nel tuo account Ranktracker.

L’API si basa sulle stesse quote relative a parole chiave, righe di dati e monitoraggio incluse nel proprio piano. I piani di livello superiore offrono quote maggiori, ma la possibilità di accedere all’API è disponibile per tutti.

Esplora la documentazione completa per gli sviluppatori all’indirizzo developers.ranktracker.com.

Perché abbiamo creato l’API di Ranktracker

I team SEO hanno sempre più bisogno di accedere ai propri dati di ricerca al di fuori di un'unica piattaforma.

Le agenzie desiderano che i dati relativi al posizionamento siano disponibili all’interno dei portali dei clienti. I team interni vogliono combinare i dati di posizionamento con quelli analitici, i lead e i ricavi. Gli sviluppatori vogliono automatizzare le attività ripetitive di gestione dei progetti. Le organizzazioni più grandi desiderano archiviare i dati SEO nei propri data warehouse e sistemi di business intelligence.

Le esportazioni manuali possono funzionare occasionalmente, ma diventano inefficienti quando i report devono essere aggiornati ogni giorno su centinaia di domini o migliaia di parole chiave.

L’API di Ranktracker risolve questo problema consentendo ai vostri sistemi di comunicare direttamente con Ranktracker.

Ora puoi recuperare i dati di posizionamento, gestire i progetti monitorati, organizzare le parole chiave e creare flussi di lavoro per la reportistica senza dover ripetere manualmente le stesse azioni all’interno della dashboard.

L’accesso all’API è incluso in ogni piano Ranktracker

L'accesso all'API non è limitato al nostro piano più costoso.

È incluso nei seguenti piani:

• Lancio
• Crescita
• Scale
• Autorità

L'attività API rientra nei limiti relativi a parole chiave, righe di dati, concorrenti e altre quote associate al tuo abbonamento.

Ad esempio, se aggiungi parole chiave tramite l'API, queste vengono conteggiate ai fini delle quote dell'account allo stesso modo delle parole chiave aggiunte tramite l'interfaccia di Ranktracker. Puoi verificare il tuo utilizzo attuale e la capacità residua a livello di programmazione prima di inviare un'importazione di grandi dimensioni.

Questo offre a ogni cliente l’opportunità di sperimentare l’automazione, indipendentemente dalle dimensioni dell’azienda o dalle risorse tecniche.

Le piccole imprese possono collegare Ranktracker a una semplice dashboard interna. Le agenzie possono automatizzare l’onboarding dei clienti e la reportistica. I team più grandi possono creare pipeline di dati complete attorno al proprio account Ranktracker.

Dati completi sulla classifica Top 100

Ranktracker è progettato per il monitoraggio completo della Top 100.

Anziché limitarsi alla prima pagina di Google, Ranktracker monitora tutte e dieci le pagine dei risultati organici. Questo ti aiuta a identificare le parole chiave che stanno iniziando a guadagnare visibilità prima ancora di raggiungere la prima pagina.

Tramite l’API, è possibile recuperare la cronologia più recente delle posizioni associata a una parola chiave monitorata, incluse informazioni quali:

• Posizione organica attuale
• Posizione assoluta nella SERP
• URL in classifica
• Variazione giornaliera del posizionamento
• Variazione settimanale del posizionamento
• Variazione mensile del posizionamento
• Volume di ricerca
• Traffico stimato
• Costo per clic
• Concorrenza
• Difficoltà della parola chiave

Ogni parola chiave monitorata può inoltre essere collegata al motore di ricerca, alla località, alla lingua e al dispositivo configurati. Ciò consente ai team di creare report molto più dettagliati rispetto a un semplice elenco delle posizioni delle parole chiave.

Monitoraggio in oltre 107.000 località

Ranktracker supporta oltre 107.000 località monitorabili, oltre al monitoraggio su desktop e dispositivi mobili e un’ampia copertura linguistica. Ciò rende l’API adatta a:

• Campagne SEO locali
• Monitoraggio delle ricerche a livello nazionale
• SEO internazionale
• Siti web multilingue
• Franchising e aziende con più sedi
• Agenzie che gestiscono clienti in mercati diversi

Una parola chiave può essere monitorata attraverso diverse combinazioni di località, lingua e dispositivo.

Ad esempio, un'agenzia potrebbe monitorare la stessa parola chiave su desktop e dispositivi mobili a Londra, Manchester e Birmingham. Ogni combinazione viene memorizzata come una riga di monitoraggio separata, offrendo all'agenzia una visione più accurata di come le prestazioni di ricerca differiscano a seconda del mercato.

Cosa è possibile fare con l’API di Ranktracker

L’API fornisce l’accesso alle risorse principali utilizzate in un account Ranktracker.

Gestire i domini

È possibile creare, recuperare, aggiornare e rimuovere i domini monitorati a livello di programmazione.

Ciò consente di integrare Ranktracker nel processo di onboarding dei clienti. Quando un cliente viene aggiunto al sistema interno, il suo dominio può essere creato automaticamente anche all’interno di Ranktracker.

Gli endpoint a livello di dominio forniscono inoltre la cronologia del posizionamento e i dati relativi alla quota di voce in un periodo selezionato. Le richieste relative alla cronologia e alla quota di voce possono coprire periodi fino a 365 giorni e possono essere filtrate per desktop, dispositivi mobili o tutti i dispositivi. Gestire i concorrenti

Aggiungi, recupera, aggiorna o rimuovi i concorrenti associati a ciascun dominio monitorato.

Questa funzione può essere utilizzata per configurare automaticamente il monitoraggio della concorrenza per i nuovi progetti o per sincronizzare le impostazioni dei clienti tra Ranktracker e un’altra piattaforma.

Aggiungi e gestisci le parole chiave

Crea parole chiave monitorate per un dominio e specifica il motore di ricerca, la località, la lingua, il dispositivo e la frequenza di monitoraggio.

L’API supporta la creazione in blocco utilizzando una combinazione di frasi chiave e configurazioni dei motori di ricerca. Invece di inviare centinaia di richieste individuali, è possibile inviare più parole e configurazioni di monitoraggio contemporaneamente. Le parole chiave possono anche essere messe in pausa, riprese o rimosse a livello di programmazione.

Recuperare la cronologia dei posizionamenti

Recupera i risultati di posizionamento più recenti per ogni parola chiave associata a un dominio.

Questi dati possono essere inviati a:

• Portali di reportistica per i clienti
• Fogli di lavoro Google
• Data warehouse
• Dashboard di business intelligence
• Sistemi di notifica interni
• Applicazioni SEO personalizzate

La documentazione include un tutorial completo per l’estrazione dei posizionamenti giornalieri e il loro caricamento in un data warehouse o in un flusso di lavoro basato su CSV. Accedi ai risultati SERP

Ogni parola chiave monitorata consente di accedere ai suoi risultati di ricerca analizzati più recenti.

Ciò include i risultati organici e le funzionalità SERP che li circondano. Ranktracker monitora funzionalità quali snippet in primo piano, risultati su mappa, video, risultati di shopping, risultati "People Also Ask" e panoramiche AI. Per le parole chiave monitorate supportate è disponibile anche l’HTML della SERP memorizzato nella cache. Ciò significa che è possibile analizzare ben più del semplice posizionamento numerico di un dominio.

È inoltre possibile capire quale tipo di risultato di ricerca viene visualizzato, quali concorrenti circondano la propria inserzione e quali funzionalità della SERP potrebbero influenzare i tassi di clic organici.

Crea report sulla quota di visibilità

L’endpoint “share-of-voice” restituisce un dato complessivo sulla visibilità, la sua variazione nel periodo selezionato e una serie giornaliera che mette a confronto il tuo dominio con i concorrenti monitorati.

Questi dati sono già strutturati per grafici e report. È possibile utilizzarli per creare un andamento della visibilità che mostri se il proprio marchio sta guadagnando o perdendo terreno rispetto ai domini concorrenti. Organizzare le parole chiave con i tag

Crea tag a livello di account e applicali alle parole chiave in diversi progetti.

I tag possono essere utilizzati per distinguere:

• Parole chiave di marca e non di marca
• Prodotti e servizi
• Paesi o località
• Campagne
• Parole chiave prioritarie
• Gruppi di reportistica dei clienti
• Diverse aree di un sito web

L'API supporta l'assegnazione di tag in blocco, consentendo di applicare un singolo tag a molte parole chiave in un'unica richiesta. Monitorare l'utilizzo dell'account

L'endpoint relativo all'utilizzo dell'account mostra quanta parte del tuo piano è stata utilizzata e quanta capacità rimane.

Riporta le quote disponibili, tra cui:

• Parole chiave attive
• Righe di dati
• Controlli su richiesta
• Crediti di SERP Analyser

Ogni quota include l’utilizzo attuale, il limite totale e la capacità residua. Ciò è particolarmente utile prima di importare un elenco di parole chiave di grandi dimensioni. La tua integrazione può verificare prima la capacità disponibile ed evitare di tentare un’importazione che superi la quota dell’account.

Progettata per le agenzie

Le agenzie sono uno dei principali gruppi che possono trarre vantaggio dalla nuova API.

Un tipico flusso di lavoro automatizzato di onboarding potrebbe:

1. Crea il dominio del cliente.
2. Aggiungi i suoi concorrenti.
3. Importa le parole chiave di destinazione.
4. Configura località, lingue e dispositivi.
5. Crea tag specifici per il cliente.
6. Invia i dati di posizionamento a una dashboard interna.
7. Genera report periodici sulla visibilità.

Un processo che in precedenza comportava molteplici passaggi manuali può ora essere integrato con il sistema di gestione dei progetti o di onboarding dei clienti dell’agenzia stessa.

Le agenzie possono inoltre importare istantanee giornaliere del posizionamento nel proprio database e presentare le informazioni all’interno di un portale white label.

Progettato per i team SEO interni

I team interni possono integrare i dati relativi alle classifiche con dati aziendali più ampi.

Ad esempio, le prestazioni delle parole chiave potrebbero essere combinate con:

• Clic su Google Search Console
• Conversioni sul sito web
• Ricavi e-commerce
• Lead generati
• Prestazioni delle pagine di destinazione
• Date di pubblicazione dei contenuti
• Aggiornamenti SEO tecnici

Ciò rende più semplice andare oltre i report di posizionamento isolati e comprendere in che modo la visibilità nei motori di ricerca contribuisca ai risultati aziendali più ampi.

Progettato per piattaforme SEO e sviluppatori

Gli sviluppatori possono utilizzare Ranktracker come livello di dati relativi al posizionamento e alla SERP alla base di strumenti interni o applicazioni rivolte ai clienti.

L’API segue una struttura REST coerente, con tutti gli endpoint di produzione che utilizzano:

https://api.ranktracker.com/v1

Le risposte utilizzano un formato in stile JSON:API. Le risorse vengono restituite sotto data, con i relativi campi all'interno di un oggetto attributes. Gli endpoint di elenco supportano l'impaginazione fino a 1.000 record per pagina e restituiscono i conteggi totali tramite le intestazioni di risposta. La documentazione fornisce attualmente esempi funzionanti per:

• cURL
• Python
• Node.js

Include inoltre tutorial completi che trattano la creazione di domini, il monitoraggio delle parole chiave, le esportazioni nel data warehouse, i report sulla quota di voce e l’assegnazione di tag alle parole chiave in blocco.

Come creare la propria chiave API

Per iniziare bastano pochi passaggi:

1. Accedi al tuo account Ranktracker.
2. Apri le impostazioni del tuo account.
3. Vai alla sezione "Chiavi API".
4. Crea una nuova chiave API.
5. Conserva la chiave in modo sicuro sul tuo server.

Le chiavi API utilizzano il formato:

tkn_usr_...

La chiave deve essere inserita direttamente nell'intestazione "Authorization ". Non è necessario il prefisso "Bearer". Di seguito è riportata una richiesta di base che elenca i domini presenti nel tuo account:

Una richiesta riuscita restituisce i domini di proprietà dell'account collegato a quella chiave.

Le chiavi API devono sempre essere trattate come password. Non devono essere inserite in repository pubblici, nel codice dei browser o nelle applicazioni mobili.

Progettata per un'automazione affidabile

L'API utilizza metodi HTTP standard e strutture di risposta prevedibili.

Supporta:

• GET per il recupero delle risorse
• POST per la creazione di risorse
• PATCH per l'aggiornamento delle risorse
• DELETE per la rimozione delle risorse

Gli errori includono codici leggibili da macchina e descrizioni, in modo che le integrazioni possano determinare se una richiesta deve essere corretta, se un account ha raggiunto il proprio limite o se una richiesta temporanea deve essere riprovata. Le operazioni k, l’impaginazione e i report sull’utilizzo aiutano inoltre a ridurre le richieste superflue nella gestione di progetti di grandi dimensioni.

Una breve nota su MCP

Ranktracker offre anche un’opzione server MCP per collegare strumenti e assistenti di intelligenza artificiale supportati ai dati di Ranktracker.

Tratteremo il server MCP, gli strumenti supportati e la procedura di connessione in un articolo a parte.

Inizia a sviluppare con l'API di Ranktracker

L'API di Ranktracker offre ai professionisti SEO un maggiore controllo su come raccogliere, organizzare e utilizzare i propri dati di ricerca.

È possibile automatizzare i flussi di lavoro di monitoraggio del posizionamento, sincronizzare i progetti, recuperare i risultati completi della Top 100, analizzare le caratteristiche delle SERP, confrontare la quota di voce e integrare i dati SEO nei sistemi già utilizzati dalla propria organizzazione.

Ma soprattutto, l’accesso all’API è ora incluso in ogni piano di Ranktracker.

Crea la tua chiave API dal tuo account Ranktracker ed esplora la documentazione all’indirizzo developers.ranktracker.com.