Docs
Rechercher dans la documentation...⌘K

Guide de l’API

Nous avons une référence complète et détaillée pour l’API v3 ici : Documentation de l’API Ahrefs. Cette page est une brève introduction à destination des développeurs Ahrefs Connect.

Ce que vous pouvez faire avec l’API v3

L’API v3 d’Ahrefs vous permet d’extraire un large éventail de données, notamment :

  • Données organiques et de backlinks issues de Site Explorer (pour votre site ou ceux de vos concurrents)
  • Indicateurs et idées de mots-clés issus de Keywords Explorer
  • Données SERP Google
  • Données des projets Rank Tracker et Site Audit de l’utilisateur
  • Et bien plus encore — nous ajoutons régulièrement de nouveaux endpoints

Unités d’API et coûts des requêtes

Toutes les requêtes — à l’exception des requêtes de test gratuites ainsi que des points de terminaison Rank Tracker, Management, Public et de quelques autres — consomment des unités d’API sur le compte de l’utilisateur connecté.

Règles de coût :

  • Dépend du nombre de lignes renvoyées et des champs demandés
  • Coût minimum pour toute requête payante : 50 unités
  • Si un point de terminaison est gratuit, cela est indiqué sur sa page de documentation

Pendant le développement

Comme expliqué dans Comment ça marche, lorsque votre application est créée pour la première fois, elle sera au statut Inactif. Dans ce mode, vous pouvez tester les flux OAuth et envoyer des requêtes de test gratuites aux points de terminaison de l’API v3 depuis votre environnement de préproduction, sans consommer d’unités. Une fois votre application approuvée et activée, les requêtes en production consommeront des unités selon les règles de coût normales.

En savoir plus : Requêtes de test gratuites et Consommation des limites de l’API

info

Bonnes pratiques pour économiser les unités d’API des utilisateurs

Lorsque vous effectuez des requêtes pour le compte des utilisateurs, gardez à l’esprit leur quota mensuel.

Voici comment minimiser la consommation d’unités :

  1. Utilisez select pour ne demander que les champs nécessaires : la plupart des points de terminaison vous permettent de spécifier les champs.
  2. Limitez le nombre de lignes : utilisez limit ou des paramètres équivalents. Évitez de récupérer des milliers de lignes sauf si nécessaire.
  3. Utilisez des points de terminaison groupés lorsque c'est possible : par exemple, batch-analysis vous permet de récupérer des métriques pour de nombreuses pages en une seule requête.
  4. Permettez aux utilisateurs de surveiller leur utilisation : le point de terminaison limits-and-usage indique combien d’unités il leur reste.