Docs
Cerca nella documentazione...⌘K

Guida API

Qui trovi una guida di riferimento completa e dettagliata per l’API v3: Documentazione API di Ahrefs. Questa pagina è una breve introduzione per gli sviluppatori di Ahrefs Connect.

Cosa puoi fare con l’API v3

Ahrefs API v3 ti consente di estrarre un’ampia gamma di dati, tra cui:

  • Dati sul traffico organico e sui Backlinks da Site Explorer (per il tuo sito o per i competitor)
  • Metriche e idee per le keyword da Keywords Explorer
  • Dati SERP di Google
  • Dati dai progetti Rank Tracker e Site Audit dell'utente
  • E altro ancora — aggiungiamo regolarmente nuovi endpoint

Unità API e costi delle richieste

Tutte le richieste — tranne le query di prova gratuite e gli endpoint Rank Tracker, Management, Public e alcuni altri — consumano unità API dall’account dell’utente collegato.

Regole di costo:

  • Dipende dal numero di righe restituite e dai campi richiesti
  • Costo minimo per qualsiasi richiesta a pagamento: 50 unità
  • Se un endpoint è gratuito, è indicato come tale nella relativa pagina di documentazione

Durante lo sviluppo

Come spiegato in Come funziona, quando la tua app viene creata per la prima volta, si troverà nello stato Inactive. In questa modalità, puoi testare i flussi OAuth e inviare richieste di prova gratuite agli endpoint API v3 dalla tua configurazione di staging senza consumare unità. Una volta che la tua app sarà approvata e attivata, le richieste in produzione consumeranno unità secondo le normali regole di costo.

Scopri di più: Query di prova gratuite e Consumo dei limiti dell’API

info

Best practice per risparmiare unità API degli utenti

Quando effettui richieste per conto degli utenti, tieni presente la loro quota mensile.

Ecco come ridurre al minimo il consumo di unità:

  1. Usa select per richiedere solo i campi necessari: la maggior parte degli endpoint consente di specificare i campi.
  2. Limita il numero di righe: usa limit o parametri equivalenti. Evita di recuperare migliaia di righe se non è necessario.
  3. Usa gli endpoint bulk quando possibile: ad esempio, batch-analysis ti permette di recuperare le metriche di molte pagine con un’unica richiesta.
  4. Consenti agli utenti di monitorare l’utilizzo: l’endpoint limits-and-usage mostra quante unità restano.