API Ahrefs : automatiser la veille concurrentielle et les mots-clés

L’API Ahrefs (version 3) donne un accès programmatique aux données de Site Explorer, Keywords Explorer, SERP Overview, Rank Tracker ou Site Audit. Pour une équipe SEO, son intérêt n’est pas d’obtenir plus de données que l’interface, mais d’extraire toujours les mêmes données, au même moment et dans le même format, pour alimenter une veille concurrentielle, un suivi de mots-clés et un plan éditorial sans copier-coller. Ce guide explique ce que l’API couvre, comment ses unités sont facturées, puis détaille trois workflows concrets que vous pouvez monter dans n8n, avec les erreurs qui font exploser la consommation.

01Ce que l’API Ahrefs permet d’automatiser

La documentation officielle, publiée sur le portail Ahrefs for Developers, décrit une API REST organisée par grandes familles d’endpoints. Elle est disponible sur les forfaits payants éligibles, avec une clé API créée depuis les paramètres du compte, et une spécification OpenAPI est fournie pour faciliter l’intégration.

Les familles d’endpoints utiles au SEO

• Site Explorer : métriques d’un domaine ou d’une URL (Domain Rating, trafic organique estimé, mots-clés positionnés), top pages, concurrents organiques, backlinks, domaines référents, ancres et historiques.
• Keywords Explorer : volume, difficulté (KD), potentiel de trafic, sujet parent, intentions, fonctionnalités de SERP, ainsi que les termes correspondants, les termes associés et les suggestions de recherche.
• SERP Overview : les résultats classés pour un mot-clé et un pays, avec leurs métriques.
• Rank Tracker : les positions de vos projets suivis et de vos concurrents.
• Batch Analysis : l’analyse de jusqu’à 100 cibles en une seule requête, pratique pour qualifier une liste de domaines.
• Site Audit et Brand Radar : les résultats de vos audits techniques et, pour Brand Radar, des données sur la présence des marques dans les réponses d’IA.

Ahrefs propose aussi un serveur MCP officiel, documenté sur le même portail, qui permet d’interroger ces données depuis un assistant IA comme Claude. C’est pratique pour une analyse exploratoire ; pour un reporting récurrent, un flux planifié qui appelle directement l’API reste plus prévisible.

Ce que l’API ne remplace pas

Les données Ahrefs sont des estimations issues de son propre crawl et de ses modèles de trafic. Elles sont très utiles pour comparer des concurrents entre eux ou suivre des tendances, mais elles ne remplacent pas vos données propriétaires. Pour vos propres pages, croisez toujours avec Google Search Console : clics et impressions réels d’un côté, estimation de marché de l’autre. Notre méthode d’analyse de positionnement SEO détaille comment articuler les deux sources sans les confondre.

02Accès, unités et coûts : lire la facture avant de coder

C’est le point à régler en premier, car il est tentant de construire le flux avant d’en estimer la consommation. Selon la page « About API v3 » du centre d’aide Ahrefs, l’API v3 est accessible à partir du forfait Lite, avec une enveloppe mensuelle d’unités qui dépend du forfait : 200 000 unités pour Lite, 800 000 pour Standard, 2 millions pour Advanced, allocation sur mesure pour Enterprise. Le nombre maximal de lignes par requête varie aussi : 100 sur Lite, 250 sur Standard, 500 sur Advanced, sans plafond sur Enterprise. Ces montants peuvent évoluer : contrôlez la page tarifaire d’Ahrefs au moment de dimensionner votre flux.

Deux autres règles de fonctionnement sont documentées :

• Limite de débit : 60 requêtes par minute par défaut. Au-delà, l’API renvoie une erreur HTTP 429.
• Cache et endpoints gratuits : une requête servie depuis le cache ne consomme pas d’unités, pas plus que les endpoints Rank Tracker, de gestion et publics.

Pour tester sans rien consommer, Ahrefs prévoit des requêtes de test gratuites : sur Site Explorer avec les domaines ahrefs.com, yep.com ou firehose.com, et sur Keywords Explorer et SERP Overview avec les mots-clés « ahrefs », « yep » ou « firehose ». Les résultats sont plafonnés à 100 lignes, et mélanger un terme gratuit avec d’autres termes fait payer toute la requête.

Calculer le coût d’une requête

La documentation Ahrefs sur la consommation d’unités donne la formule : le coût d’une requête est le maximum entre un coût de base de 50 unités et le coût par ligne multiplié par le nombre de lignes. Le coût par ligne est la somme des coûts de chaque champ unique présent dans les paramètres select, where et order_by, un champ présent dans plusieurs paramètres n’étant compté qu’une fois. Un champ coûte 1 unité par défaut, certains champs coûtent 5 ou 10 unités.

L’exemple officiel est parlant : une requête de backlinks avec trois champs uniques, dont un champ de trafic à 10 unités, qui renvoie 500 lignes, coûte (1 + 1 + 10) x 500, soit 6 000 unités. Retirez le champ à 10 unités et la même requête passe à 1 000 unités. Avant de planifier un flux, faites donc ce calcul pour chaque appel :

coût mensuel = nombre d'appels par mois
             x max(50, somme des coûts de champs x lignes renvoyées)

03Trois workflows de veille concurrentielle et mots-clés

Les trois flux suivants couvrent l’essentiel des besoins d’une équipe SEO ou contenu. Ils se complètent : le premier identifie qui compte, le deuxième ce qui marche chez eux, le troisième ce que vous devez produire.

1. Suivi mensuel des concurrents organiques

Objectif : savoir qui gagne ou perd de la visibilité sur votre marché, sans refaire l’analyse à la main chaque mois.

• Appel : endpoint des concurrents organiques de Site Explorer sur votre domaine, pays France, limité aux 20 premiers résultats.
• Champs : domaine concurrent, mots-clés communs, part de mots-clés, trafic estimé. Limitez-vous à ce que vous lirez vraiment.
• Enrichissement : une requête Batch Analysis sur la liste obtenue pour récupérer Domain Rating et trafic de chaque concurrent en un seul appel.
• Sortie : une ligne par concurrent et par mois dans Google Sheets ou BigQuery, pour suivre les évolutions dans le temps.

2. Surveillance des top pages concurrentes

Objectif : repérer les pages qui génèrent le plus de trafic estimé chez vos concurrents, et surtout celles qui progressent.

• Appel : endpoint des top pages de Site Explorer pour chaque concurrent prioritaire (cinq au maximum pour commencer), filtré sur les pages au-dessus d’un seuil de trafic.
• Traitement : le paramètre date_compared permet d’obtenir, via les champs suffixés _prev, les valeurs à une date de comparaison. Chaque champ ajouté augmente le coût par ligne : si vous historisez déjà chaque mois, comparez plutôt avec votre extraction précédente.
• Sortie : une liste courte de pages à analyser manuellement (format, angle, profondeur, fraîcheur).

3. Extraction de mots-clés pour le plan éditorial

Objectif : transformer une liste de thèmes en mots-clés qualifiés, prêts à être priorisés.

• Appel 1 : termes correspondants ou termes associés de Keywords Explorer à partir de vos mots-clés de départ, filtrés par volume minimal.
• Appel 2 : overview de Keywords Explorer sur la sélection, pour récupérer volume, KD, potentiel de trafic, sujet parent, intentions et fonctionnalités de SERP.
• Appel 3 : SERP Overview sur les mots-clés retenus pour vérifier la nature des pages qui se positionnent (guides, pages produits, outils, contenus d’actualité).
• Sortie : une table de mots-clés regroupés par sujet parent, qui évite de créer plusieurs pages sur la même intention.

Le sujet parent et la présence d’un AI Overview dans les fonctionnalités de SERP sont deux colonnes à ne jamais retirer : la première limite la cannibalisation, la seconde indique les requêtes où la visibilité se joue aussi dans les réponses générées.

04Mettre en place le flux dans n8n

n8n se prête bien à ce type d’automatisation, parce qu’il gère la planification, les appels HTTP, les transformations et l’écriture dans vos outils de destination. Pour une vue d’ensemble des usages possibles, voyez notre page sur l’automatisation SEO avec n8n. La mise en place type suit six étapes :

1. Stocker la clé API dans un identifiant n8n de type en-tête HTTP (Authorization: Bearer suivi de votre clé), jamais en clair dans un nœud.
2. Planifier avec un Schedule Trigger : mensuel pour les concurrents et les top pages, à la demande pour la recherche de mots-clés.
3. Appeler l’API avec un nœud HTTP Request vers https://api.ahrefs.com/v3/ suivi de l’endpoint voulu, en passant les paramètres select, where, order_by, limit et country.
4. Respecter la limite de débit : traitez les cibles par lots avec un nœud Loop Over Items et une temporisation entre les appels, et prévoyez une nouvelle tentative différée sur les erreurs 429.
5. Normaliser les réponses avec un nœud Code : noms de colonnes stables, date d’extraction, identifiant de la cible, pays.
6. Écrire dans Google Sheets pour un usage éditorial, ou dans BigQuery si vous croisez ces données avec Search Console et GA4.

Exemple de paramètres pour l’extraction des top pages d’un concurrent :

GET https://api.ahrefs.com/v3/site-explorer/top-pages
  target=concurrent.fr
  mode=domain
  country=fr
  date=2026-09-01
  select=url,sum_traffic,keywords,top_keyword
  order_by=sum_traffic:desc
  limit=50

Avec ces quatre champs, le coût par ligne est de 13 unités : sum_traffic compte 10 unités, les trois autres 1 unité chacun. Pour 50 lignes, la requête coûte donc 650 unités, et 3 250 unités pour cinq concurrents. La documentation de l’endpoint des top pages indique bien 10 unités pour sum_traffic ; relisez le coût des champs de chaque endpoint avant la mise en production, car il conditionne directement la facture.

05Erreurs fréquentes et bonnes pratiques

Les dérives de coût et de qualité viennent presque toujours des mêmes causes.

• Sélectionner tous les champs : chaque champ ajouté augmente le coût de chaque ligne. Partez des questions que votre rapport doit trancher, puis choisissez les champs.
• Oublier les champs de filtre et de tri : un champ utilisé dans where ou order_by est facturé même s’il n’est pas renvoyé.
• Extraire trop de lignes : 50 top pages par concurrent suffisent souvent à repérer les tendances. Le paramètre limit est votre premier levier d’économie.
• Relancer inutilement : historisez chaque extraction et ne réinterrogez pas une donnée mensuelle plusieurs fois dans le mois.
• Déboguer sur de vraies cibles : chaque essai consomme des unités. Validez d’abord la structure du flux avec les requêtes gratuites sur ahrefs.com.
• Confondre estimation et mesure : un trafic estimé en hausse chez un concurrent est un signal à vérifier dans la SERP, pas un fait établi.
• Ignorer le pays : sans paramètre country cohérent, vous comparez des marchés différents.

Ces automatisations trouvent naturellement leur place dans une stack plus large. Notre article sur la stack d’outils SEO pour l’audit, le contenu, le netlinking et le reporting aide à répartir les rôles entre Ahrefs, Search Console, un crawler et vos outils de visualisation.

06Du tableau de données au plan éditorial

Une extraction automatisée n’a de valeur que si elle débouche sur des décisions. Voici une routine mensuelle simple, que vous pouvez appliquer dès le premier cycle :

1. Lire les mouvements concurrents : quels domaines entrent dans le top 20 de vos concurrents organiques, lesquels reculent.
2. Qualifier les pages en hausse : pour chaque top page concurrente en progression, notez le sujet, le format et ce que votre site propose déjà sur ce sujet.
3. Croiser avec vos mots-clés : rapprochez les sujets parents extraits de Keywords Explorer de vos pages existantes pour distinguer création, mise à jour et regroupement de contenus.
4. Prioriser selon le potentiel de trafic, la difficulté, l’adéquation avec votre offre et l’effort de production.
5. Vérifier la faisabilité technique des pages à mettre à jour : indexation, maillage, temps de chargement. Notre guide complet de l’audit SEO technique fournit les points de contrôle.

Pour aller plus loin dans l’interprétation, notre méthode d’analyse SEO pour passer des données aux décisions propose un cadre pour hiérarchiser les signaux et éviter de réagir à chaque variation.

Dernier point, lié au GEO : l’endpoint des top pages expose aussi des champs comptant les réponses de ChatGPT, Perplexity, Gemini, Copilot, AI Overviews ou AI Mode dans lesquelles une page apparaît. Ces champs s’appuient sur l’index Brand Radar, dont l’accès est requis, et coûtent 10 unités chacun. Ajoutés à la surveillance des top pages concurrentes, ils montrent quelles pages sont reprises par les moteurs de réponse, pas seulement lesquelles captent du trafic organique. L’API Ahrefs ne fait pas le travail éditorial à votre place, mais elle vous rend le temps de le faire.