Introduction
Avec l’API Ahrefs, vous pouvez utiliser les données de votre espace de travail Ahrefs pour créer des intégrations et des automatisations personnalisées. Actuellement, l’API v3 vous permet d’extraire des données des points de terminaison Site Explorer, Keywords Explorer, Aperçu SERP, Rank Tracker, Site Audit, Brand Radar et Social Media Management, ainsi que de gérer vos projets Rank Tracker et vos listes Keywords Explorer :
- Site Explorer : statistiques générales et graphiques historiques, Backlinks, rapports sur le trafic organique et payant
- Keywords Explorer : métriques pour un mot-clé unique ou une liste de mots-clés, historique du volume de recherche et volume par pays, rapports d’idées de mots-clés
- Site Audit : scores de santé des projets, rapports complets sur les problèmes et contenu des pages explorées
- Aperçu SERP : les 100 meilleurs résultats de la SERP
- Rank Tracker : aperçu du projet, rapports sur les concurrents et SERP de Rank Tracker
- Batch Analysis : métriques pour jusqu’à 100 cibles par requête
- Brand Radar : statistiques générales de la marque, graphiques de performances historiques et prompts réels avec citations provenant de plusieurs agents IA
- Gestion des réseaux sociaux : canaux, publications, historique d’activité et métriques des comptes de réseaux sociaux connectés
- Gestion : endpoints pour gérer vos projets Rank Tracker et vos listes Keywords Explorer
- Informations sur l’abonnement : vos limites d’API et votre utilisation
- Endpoints publics : adresses IP et plages IP de notre crawler
Éligibilité
L’API Ahrefs est disponible avec des forfaits payants éligibles. Avec tous les autres forfaits, vous aurez toujours accès à un ensemble limité de requêtes de test gratuites.
Limites du forfait
Toutes les requêtes, à l’exception des requêtes de test gratuites et des points de terminaison Rank Tracker, Management, Public et de quelques autres, consomment des unités d’API. Le coût dépend du nombre de lignes dans une réponse et des champs demandés. Le coût minimum de toute requête est de 50 unités. Si un point de terminaison est gratuit, vous verrez une note à ce sujet sur sa page de documentation ; sinon, il consomme des unités.
Guide connexe : Consommation des limites
info
Veuillez noter que les unités d’API, une fois consommées, ne sont pas remboursables. Nous recommandons vivement d’utiliser nos requêtes de test gratuites pour tout développement et toute phase de test, afin de limiter tout risque d’utilisation involontaire d’unités d’API.
Nous recommandons également de définir des limites sur vos clés API, en particulier pendant la phase de test et de développement.
Les forfaits payants éligibles incluent un quota mensuel d’unités d’API. Sur les forfaits qui prennent en charge l’utilisation en paiement à l’usage, des unités supplémentaires sont automatiquement facturées une fois la limite incluse dépassée.
Si vous avez un abonnement annuel, vous pouvez faire des économies en payant à l’avance plus d’unités d’API à un tarif réduit. Vous pouvez suivre la consommation d’unités d’API et acheter des options prépayées dans Paramètres du compte / Limites et utilisation.
Voir aussi : Page des tarifs
Clés API
Pour envoyer des requêtes à l’API Ahrefs, vous aurez besoin d’une clé API. Seuls les propriétaires de l’espace de travail et les administrateurs peuvent créer et gérer des clés API. Cela peut être effectué dans Paramètres du compte / Clés API.
Guide associé : Création et gestion des clés API
Utilisation de base
Démarrez rapidement grâce à ces boutons d'API dans les rapports Ahrefs. Cliquez dessus pour afficher la requête sous forme de commande cURL.
Ces boutons peuvent servir de générateur de requêtes, puisque la commande cURL sera mise à jour dynamiquement avec tous les filtres que vous appliquez au rapport.
Notez que cURL contient tous les champs et métriques affichés dans le rapport actuel. Vous pouvez supprimer les champs dont vous n’avez pas besoin afin de réduire le coût d’une requête.
Pour tous les détails d’utilisation, consultez notre référence API dans cette documentation. La référence contient une spécification compatible OpenAPI décrivant le format de requête et de réponse de chaque point de terminaison.
Limitation de débit
L’API Ahrefs est limitée par défaut à 60 requêtes par minute. Si cette limite est dépassée, l’API renverra un code d’état HTTP 429 (Too Many Requests).
Si cette limite est dépassée, l'API répondra avec un code d'état HTTP 429 (Too Many Requests). Le bridage se produit de manière dynamique en fonction de la charge du système en temps réel, de la disponibilité des ressources et des besoins de calcul de vos requêtes.