Introduzione
Con l'API di Ahrefs puoi usare i dati della tua area di lavoro Ahrefs per creare integrazioni e automazioni personalizzate. Attualmente, l’API v3 consente di estrarre dati dagli endpoint di Site Explorer, Keywords Explorer, Panoramica SERP, Rank Tracker, Site Audit, Brand Radar e Social Media Management, oltre a gestire i progetti di Rank Tracker e gli elenchi di Keywords Explorer:
- Site Explorer: statistiche generali e grafici storici, Backlink, report sul traffico organico e a pagamento
- Keywords Explorer: metriche per una singola parola chiave o un elenco di parole chiave, storico del volume di ricerca e volume per paese, report di idee per parole chiave
- Site Audit: punteggi di salute dei progetti, report completi sui problemi e contenuti delle pagine sottoposte a crawl
- Panoramica SERP: i primi 100 risultati SERP
- Rank Tracker: panoramica del progetto, report sui competitor e SERP di Rank Tracker
- Batch Analysis: metriche per un massimo di 100 target per richiesta
- Brand Radar: statistiche generali del brand, grafici storici delle performance e prompt reali con citazioni su più agenti IA
- Gestione dei social media: canali, post, cronologia delle attività e metriche per gli account social media connessi
- Gestione: endpoint per gestire i tuoi progetti Rank Tracker e gli elenchi di Keywords Explorer
- Informazioni sull’abbonamento: i tuoi limiti API e l’utilizzo
- Endpoint pubblici: indirizzi IP e intervalli del nostro crawler
Idoneità
L'API di Ahrefs è disponibile nei piani a pagamento idonei. Con tutti gli altri piani avrai comunque accesso a un set limitato di query di test gratuite.
Limiti del piano
Tutte le richieste, tranne le query di test gratuite e gli endpoint Rank Tracker, Management, Public e alcuni altri, consumano unità API. Il costo dipende dal numero di righe nella risposta e dai campi richiesti. Il costo minimo per qualsiasi richiesta è 50 unità. Se un endpoint è gratuito, vedrai una nota a riguardo nella sua pagina di documentazione; in caso contrario, consuma unità.
Guida correlata: Consumo dei limiti
info
Tieni presente che le unità API, una volta consumate, non sono rimborsabili. Consigliamo vivamente di usare le nostre query di test gratuite per tutte le attività di sviluppo e test, così da ridurre eventuali consumi involontari di unità API.
Consigliamo inoltre di impostare dei limiti sulle tue chiavi API, soprattutto durante la fase di sviluppo e test.
I piani a pagamento idonei includono un'allocazione mensile di unità API. Nei piani che supportano l’utilizzo pay-as-you-go, le unità aggiuntive vengono addebitate automaticamente una volta superato il limite incluso.
Se hai un abbonamento annuale, puoi risparmiare pagando in anticipo più unità API a una tariffa scontata. Puoi monitorare il consumo di unità API e acquistare componenti aggiuntivi prepagati in Impostazioni account / Limiti e utilizzo.
Vedi anche: Pagina dei prezzi
Chiavi API
Per inviare richieste ad Ahrefs API, ti serve una chiave API. Solo i proprietari dell’area di lavoro e gli amministratori possono creare e gestire le chiavi API. Puoi farlo in Impostazioni account / Chiavi API.
Guida correlata: Creazione e gestione delle chiavi API
Utilizzo di base
Per iniziare rapidamente, usa questi pulsanti API nei Report Ahrefs. Fai clic su di essi per visualizzare la richiesta come comando cURL.
Questi pulsanti possono essere usati come generatore di query, poiché il comando cURL si aggiornerà dinamicamente con qualsiasi filtro applicato al report.
Tieni presente che cURL contiene tutti i campi e le metriche mostrati nel report corrente. Puoi rimuovere i campi che non ti servono per ridurre il costo di una richiesta.
Per i dettagli completi sull’utilizzo, consulta il nostro riferimento API in questa documentazione. Il riferimento include una specifica compatibile con OpenAPI del formato di richiesta e risposta di ciascun endpoint.
Limitazione della frequenza
Ahrefs API è limitata per impostazione predefinita a 60 richieste al minuto. Se questo limite viene superato, l’API risponderà con un codice di stato HTTP 429 (Too Many Requests).
Inoltre, per mantenere prestazioni ottimali e la stabilità del sistema, le richieste API possono occasionalmente essere rifiutate con lo stesso codice di stato HTTP 429 a causa del throttling. Il throttling avviene in modo dinamico in base al carico del sistema in tempo reale, alla disponibilità di risorse e alle esigenze di calcolo delle tue richieste.