Ahrefs Domain Overview
Le node Ahrefs Domain Overview lit le Domain Rating, le volume de backlinks et le trafic organique estimé d'un domaine via l'API Ahrefs v3, avec un cache par intégration Ahrefs pour économiser les unités d'API.
Que fait le node Ahrefs Domain Overview ?
Le node Ahrefs Domain Overview lit l’état actuel d’un domaine depuis l’API Ahrefs v3 Site Explorer : son Domain Rating et son Ahrefs Rank, le nombre de backlinks et de domaines référents, et son trafic organique estimé avec le nombre de mots-clés et la valeur du trafic.
Trois endpoints Ahrefs distincts répondent à ces trois questions — domain-rating, backlinks-stats et metrics — et ils ne partagent rien d’autre que la cible. Le node les exécute ensemble : un workflow a donc besoin d’un node et non de trois.
Chaque groupe de métriques est un appel facturé séparément, et c’est pour cela que chacun a son interrupteur : un workflow qui ne suit que le Domain Rating ne doit pas payer une estimation de trafic qu’il jette. Chaque réponse est mise en cache par intégration Ahrefs de l’organisation : une lecture répétée avec la même intégration — une nouvelle exécution, ou un second workflow qui pose la même question — ne consomme aucune unité d’API.
Cas d’usage courants :
- Vérifier l’autorité d’un domaine avant et après une campagne de netlinking.
- Comparer un portefeuille de domaines à la même date.
- Qualifier des prospects backlinks par Domain Rating et domaines référents.
- Capturer un instantané mensuel du trafic, des mots-clés et des backlinks en un seul node.
- Comparer un site à ses concurrents sur des métriques identiques.
Mise en place rapide
Connectez votre compte Ahrefs
Dans la barre latérale Draft & Goal, ouvrez Intégrations et connectez votre token d’API Ahrefs. Vous pouvez en générer un dans le tableau de bord Ahrefs, sous Account settings > API keys ; sans lui, le node refuse de s’exécuter.
Ajoutez le node au canvas
Ouvrez la bibliothèque de nodes, allez dans Intégrations > Outils SEO > Ahrefs, puis glissez le node Ahrefs Domain Overview sur votre espace de travail.
Renseignez la cible
Saisissez le domaine dans le champ Target, ou connectez le port d’entrée Target à un node en amont (Url, Text, Loop Node…). Le protocole est retiré à l’enregistrement : https://example.com et example.com partagent donc une seule ligne de cache.
Choisissez les groupes de métriques
Ne laissez actifs que les groupes que vous consommez réellement. Chacun est un appel facturé, et le panneau de réglages affiche votre solde d’unités restant.
Choisissez une fenêtre de cache
24 heures est la valeur par défaut. Élargissez-la pour un rapport qui tolère des chiffres de la veille, réduisez-la quand la fraîcheur compte plus que le coût.
Connectez les sorties
Branchez Domain Rating sur un Conditional Node pour un test de seuil, ou Overview sur un LLM ou un écriture Google Sheets pour la charge utile complète.
Paramètres de configuration
Champs obligatoires
Intégration Ahrefs integration required Intégration — Le compte Ahrefs connecté dont le token authentifie l’appel.
Target string required Domaine ou URL cible — Le site à lire. Le protocole (http://, https://) et le slash final sont retirés à l’enregistrement : deux écritures du même site tapent donc la même ligne de cache au lieu d’être facturées deux fois.
Scope enum required default: domain Portée de la cible — Comment Ahrefs interprète la cible : domain (l’hôte, sans ses sous-domaines), subdomains (l’hôte et tout ce qui est en dessous), prefix (toutes les URL sous un chemin) ou exact (une seule URL).
Cache window enum required default: 24h Fenêtre de cache — Combien de temps une réponse reste réutilisable : off, 1h, 6h, 24h, 7d ou 30d. off désactive la lecture comme l’écriture, et facture chaque exécution.
Champs optionnels
Protocol enum default: both Protocole — Restreint la lecture à http, https, ou both.
Date string Date de l’instantané — Une date YYYY-MM-DD. Laissée vide, la date du jour est envoyée : Ahrefs exige une date sur ces endpoints et refuse l’appel sans elle, donc « les données les plus récentes » s’écrit « aujourd’hui » plutôt que « paramètre absent ».
Country string Pays — Un code ISO 3166-1 alpha-2 en minuscules qui ne s’applique qu’à l’estimation de trafic. Vide signifie « monde entier ». Le Royaume-Uni est gb et non uk, et eu n’est pas un pays accepté par Ahrefs.
Volume mode enum default: monthly Mode de volume — Volumes de recherche du dernier mois (monthly) ou moyenne sur douze mois (average).
Domain Rating boolean default: true Lire le Domain Rating — Un appel facturé. Renvoie domain_rating et ahrefs_rank.
Backlinks boolean default: true Lire les compteurs de backlinks — Un appel facturé. Renvoie les backlinks et domaines référents vivants et historiques.
Organic traffic boolean default: true Lire l’estimation de trafic — Un appel facturé, le plus coûteux des trois. Renvoie trafic organique et payant, nombre de mots-clés et valeur du trafic.
Force refresh boolean default: false Ignorer le cache — Saute la réponse en cache et appelle Ahrefs. La réponse fraîche est tout de même écrite en cache.
Désactiver les deux groupes que vous ne lisez pas transforme un node à trois appels en node à un appel. C’est la plus grosse économie disponible sur ce node, et elle est gratuite.
Que renvoie le node ?
Le node expose quatre ancres de sortie plutôt qu’une, afin qu’un node en aval reçoive ce qu’il a demandé et non la charge utile entière :
| Ancre | Contenu |
|---|---|
| Domain Rating | Le score seul, pour un test de seuil ou un graphique |
| Backlinks | Backlinks et domaines référents, vivants et historiques |
| Traffic | Trafic organique estimé, nombre de mots-clés et valeur du trafic |
| Overview | La charge utile complète, rapport de cache inclus |
overview string Une charge utile JSON avec les groupes de métriques demandés, la provenance et le rapport de cache.
{
"target": "example.com",
"mode": "domain",
"date": "2026-10-21",
"domain_rating": 76.5,
"ahrefs_rank": 42138,
"backlinks": {
"live": 184320,
"all_time": 402911,
"live_refdomains": 5120,
"all_time_refdomains": 9874
},
"traffic": {
"org_traffic": 328400,
"org_keywords": 94120,
"org_keywords_top_3": 2150,
"org_cost_cents": 41200000,
"paid_traffic": 1200,
"paid_keywords": 85,
"paid_cost_cents": 320000,
"paid_pages": 40
},
"retrieved_at": "2026-10-21T16:04:11Z",
"source": "Ahrefs API v3 (Site Explorer)",
"cache": {
"hits": [{ "endpoint": "domain-rating", "cached_at": "2026-10-21T08:12:03Z" }],
"misses": ["backlinks-stats", "metrics"],
"units_cost": 142
}
}Les coûts sont exprimés en centimes de dollar, exactement comme Ahrefs les renvoie. La valeur brute est conservée pour qu’une somme en aval ne soit pas arrondie deux fois.
Exemples d’utilisation
Exemple 1 : qualifier une liste de prospects backlinks
Vous avez une liste de domaines candidats et vous voulez garder ceux dont le Domain Rating atteint 40.
Workflow :
- Un node Text liste les domaines prospects, un par ligne.
- Un Loop Node les parcourt et alimente l’entrée Target.
- Ahrefs Domain Overview s’exécute avec Backlinks et Organic traffic désactivés — un appel facturé par domaine au lieu de trois.
- L’ancre Domain Rating alimente un Conditional Node qui teste
>= 40. - Les domaines qualifiés sont ajoutés à un onglet Google Sheets.
Exemple 2 : instantané client mensuel
Workflow :
- Un node Date fournit le premier jour du mois.
- Ahrefs Domain Overview lit les trois groupes avec Cache window à
30d. - L’ancre Overview alimente un Merge With Template qui produit le corps du rapport.
- Un Email Sender le délivre.
Avec une fenêtre de 30 jours, relancer le workflow pendant le mois ne coûte rien.
Problèmes courants
Le node échoue avec `Ahrefs API token not configured`
Cause : Aucune intégration Ahrefs n’est rattachée au node, ou l’intégration a été supprimée.
Solution : Ouvrez les réglages du node et sélectionnez une intégration Ahrefs valide. Vérifiez dans la page Intégrations que le token est toujours actif côté Ahrefs.
`Select at least one Ahrefs metric group`
Cause : Les trois interrupteurs — Domain Rating, Backlinks, Organic traffic — sont désactivés : il n’y a rien à lire.
Solution : Réactivez-en au moins un.
`Ahrefs rejects country='uk'`
Cause : Ahrefs attend un code ISO 3166-1 alpha-2 en minuscules issu de sa propre liste de 210 pays. uk et eu n’y figurent pas.
Solution : Utilisez gb pour le Royaume-Uni, et choisissez un pays unique plutôt qu’une région. Le message d’erreur énumère ce que l’API accepte.
L'exécution renvoie une 402 ou une 429
Cause : Une 402 signifie que le solde d’unités est épuisé ; une 429, trop d’appels dans une fenêtre trop courte.
Solution : Vérifiez le solde affiché dans le panneau de réglages. Le node ne réessaie jamais un appel de lui-même, parce qu’un appel parvenu à Ahrefs a peut-être déjà été facturé. Élargissez la fenêtre de cache, ou désactivez les groupes inutiles.
Bonnes pratiques et pièges
Chaque appel est facturé en unités d’API — un coût fixe par appel plus un coût par ligne. off sur la fenêtre de cache signifie que chaque exécution paie de nouveau. Gardez la fenêtre aussi large que le rapport le permet, et laissez Force refresh désactivé sauf si un changement doit être visible immédiatement.
Le cache est partagé entre les workflows de l’organisation qui utilisent la même intégration Ahrefs, et clé sur l’endpoint et ses paramètres, pas sur le node. Deux workflows qui posent la même question avec la même intégration ne paient qu’une fois ; deux intégrations différentes ne partagent pas leurs réponses.
Pour une tendance plutôt qu’un chiffre unique, utilisez Ahrefs Domain History : un appel renvoie toute la plage, là où deux Domain Overview sur deux dates renvoient deux points pour deux prix.
Comment s’intègre-t-il dans un workflow ?
graph LR
Text[Text<br/>domaines prospects] --> Loop[Loop Node]
Loop --> Overview[Ahrefs Domain Overview]
Overview -->|Domain Rating| Cond{DR >= 40 ?}
Cond -->|Oui| Sheets[Google Sheets<br/>qualifiés]
Cond -->|Non| Drop[Écartés]Nodes associés
Les mêmes métriques en série sur une plage de dates, avec l’évolution du premier au dernier point.
Les mots-clés derrière l’estimation de trafic, avec position et page d’atterrissage.
Un second avis sur l’autorité, avec Trust Flow et Citation Flow.
Mettre les métriques en forme dans un rapport lisible.