Ahrefs Domain History
Le node Ahrefs Domain History lit l'évolution du Domain Rating, des domaines référents et du trafic organique d'un domaine sur une plage de dates, avec l'évolution du premier au dernier point calculée par métrique.
Que fait le node Ahrefs Domain History ?
Le node Ahrefs Domain History lit l’évolution d’un domaine sur une plage de dates : son Domain Rating, ses domaines référents et son trafic organique estimé, une série par métrique.
Un instantané dit ce que vaut un domaine aujourd’hui ; seule une série dit si c’est une bonne nouvelle. Ahrefs expose trois endpoints d’historique — domain-rating-history, refdomains-history et metrics-history — tous indexés sur la même plage de dates et le même regroupement, et aucun n’est joint aux autres. Ce node les exécute ensemble et ajoute un bloc change qui compare le premier point de chaque série au dernier.
Cette comparaison est calculée côté serveur volontairement. C’est ce que tout rapport lit en premier, et se tromper est facile : un premier point à zéro n’a pas de croissance en pourcentage qui veuille dire quelque chose, et deux séries ont rarement exactement le même nombre de points.
Cas d’usage courants :
- Mesurer l’effet d’une campagne de netlinking sur plusieurs mois.
- Rapporter une tendance plutôt qu’un chiffre unique.
- Détecter quand une baisse de trafic ou une perte de backlinks a commencé.
- Comparer le rythme de croissance d’un site à celui d’un concurrent.
- Alimenter un graphique avec une série prête à l’emploi.
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.
Ajoutez le node au canvas
Ouvrez la bibliothèque de nodes, allez dans Intégrations > Outils SEO > Ahrefs, puis glissez le node Ahrefs Domain History sur votre espace de travail.
Renseignez la cible et la plage
Remplissez Target et Start date. Laissez End date vide pour aller jusqu’à aujourd’hui — c’est ce qu’attend un workflow planifié, car une date de fin figée rapporte indéfiniment la même fenêtre.
Choisissez le regroupement
Monthly est la valeur par défaut et la moins chère. Weekly, et surtout daily, multiplient le nombre de lignes facturées pour la même tendance.
Choisissez les séries
Désactivez celles que vous ne lisez pas. Chacune est un appel facturé séparément.
Connectez les sorties
Branchez Change sur un LLM ou un Conditional Node pour les seuls écarts, ou une ancre de série sur un graphique ou une feuille.
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 et le slash final sont retirés à l’enregistrement : deux écritures partagent une seule réponse en cache.
Scope enum required default: domain Portée de la cible — domain, subdomains, prefix ou exact.
Start date string required Premier point de la série — Une date YYYY-MM-DD. Validée localement : une date mal formée fait échouer le node avant qu’un appel facturé ne soit émis.
Grouping enum required default: monthly Granularité de la série — Un point par période daily, weekly ou monthly. C’est le principal levier de coût du node.
Cache window enum required default: 24h Fenêtre de cache — off, 1h, 6h, 24h, 7d ou 30d.
Champs optionnels
End date string Dernier point de la série — Une date YYYY-MM-DD. Vide signifie aujourd’hui.
Protocol enum default: both Protocole — http, https ou both.
Country string Pays — Un code ISO 3166-1 alpha-2 en minuscules qui ne s’applique qu’à la série de trafic. Vide signifie « monde entier ».
Volume mode enum default: monthly Mode de volume — Volumes du dernier mois (monthly) ou moyenne sur douze mois (average).
Domain Rating boolean default: true Lire la série du Domain Rating — Un appel facturé.
Referring domains boolean default: true Lire la série des domaines référents — Un appel facturé.
Organic traffic boolean default: true Lire la série de trafic — Un appel facturé.
Traffic columns array Colonnes de la série de trafic — org_traffic, org_cost, paid_traffic, paid_cost. Vide renvoie toutes les colonnes. date est toujours rajoutée : une série sans ses dates ne peut pas être tracée, et c’est la seule colonne qui ne coûte rien à transporter.
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 mise en cache.
Le regroupement détermine la facture. Ahrefs facture à la ligne renvoyée : une série quotidienne sur un an fait 365 lignes par métrique là où une série mensuelle en fait 12 — environ trente fois le coût pour la même tendance. N’utilisez daily que si le jour exact où une métrique a bougé compte vraiment.
Que renvoie le node ?
Cinq ancres, pour qu’un node qui veut les écarts ne reçoive pas trois séries complètes :
| Ancre | Contenu |
|---|---|
| Change | Comparaison premier/dernier point, par métrique |
| Domain Rating history | La série du DR |
| Referring domains history | La série des domaines référents |
| Traffic history | La série de trafic |
| History | La charge utile complète, rapport de cache inclus |
history string Une charge utile JSON avec une série par métrique demandée, le bloc d’évolution, la provenance et le rapport de cache.
{
"target": "example.com",
"mode": "domain",
"date_from": "2026-01-01",
"date_to": "2026-10-21",
"history_grouping": "monthly",
"domain_rating_history": [
{ "date": "2026-01-01", "domain_rating": 71.2 },
{ "date": "2026-10-01", "domain_rating": 76.5 }
],
"refdomains_history": [
{ "date": "2026-01-01", "refdomains": 4210 },
{ "date": "2026-10-01", "refdomains": 5120 }
],
"traffic_history": [
{ "date": "2026-01-01", "org_traffic": 240100 },
{ "date": "2026-10-01", "org_traffic": 328400 }
],
"change": {
"domain_rating": {
"from": 71.2, "from_date": "2026-01-01",
"to": 76.5, "to_date": "2026-10-01",
"absolute": 5.3, "percent": 7.44
},
"refdomains": {
"from": 4210, "from_date": "2026-01-01",
"to": 5120, "to_date": "2026-10-01",
"absolute": 910, "percent": 21.62
},
"org_traffic": {
"from": 240100, "from_date": "2026-01-01",
"to": 328400, "to_date": "2026-10-01",
"absolute": 88300, "percent": 36.78
}
},
"retrieved_at": "2026-10-21T16:04:11Z",
"source": "Ahrefs API v3 (Site Explorer)",
"cache": { "hits": [], "misses": ["domain-rating-history"], "units_cost": 86 }
}
Une métrique dont la série compte moins de deux points exploitables est absente du bloc d’évolution, et non rapportée comme une évolution nulle. « Pas de données » et « pas de mouvement » ne sont pas la même réponse, et un rapport qui les confond lit une série manquante comme une série stable. Un premier point à zéro donne "percent": null, jamais un infini.
Exemples d’utilisation
Exemple 1 : rapport de tendance sur douze mois
Workflow :
- Ahrefs Domain History avec Start date
2026-01-01, Groupingmonthly, Cache window7d. - L’ancre History alimente un node Merge With Template.
- Le résultat est écrit dans un document Google Docs.
Exemple 2 : mesure d’une campagne
Workflow :
- Ahrefs Domain History sur la fenêtre de campagne, Grouping
weekly, Organic traffic désactivé. - L’ancre Change — quatre nombres plutôt que trois séries complètes — alimente un LLM chargé d’expliquer ce qui a bougé.
Exemple 3 : alerte sur baisse de trafic
Workflow :
- Ahrefs Domain History avec uniquement Organic traffic actif et Traffic columns limité à
org_traffic. Une série, une colonne : la version la moins chère possible de ce node. - Un Conditional Node compare l’évolution du trafic à un seuil.
- Un Email Sender prévient l’équipe quand il est franchi.
Exemple 4 : comparer la croissance des concurrents
Workflow :
- Un node Text liste les concurrents.
- Un Loop Node alimente l’entrée Target.
- Ahrefs Domain History renvoie chaque série.
- L’ancre Change est ajoutée à un onglet Google Sheets, une ligne par concurrent.
Problèmes courants
`The Ahrefs start date must be a date in YYYY-MM-DD format`
Cause : La date de début ou de fin est vide, ou écrite dans un autre format.
Solution : Utilisez 2026-01-01. Ahrefs rejetterait la valeur gratuitement, mais son message nomme le paramètre et pas le format : le node la vérifie donc localement et nomme les deux.
`The Ahrefs start date is after the end date`
Cause : La plage est à l’envers, généralement parce qu’un node en amont a fourni les dates dans le mauvais ordre.
Solution : Inversez-les, ou laissez End date vide pour aller jusqu’à aujourd’hui.
Une métrique manque dans le bloc d'évolution
Cause : Sa série compte moins de deux points exploitables — une plage trop courte pour le regroupement choisi, ou un domaine sur lequel Ahrefs a peu d’historique.
Solution : Élargissez la plage de dates, ou passez le regroupement en weekly ou daily pour que la plage contienne plus d’un point.
`The Ahrefs refdomains-history endpoint returns a fixed set of metrics and ignores a column selection`
Cause : La sélection de colonnes ne s’applique qu’à la série de trafic. Les deux autres endpoints renvoient une forme fixe.
Solution : Réservez Traffic columns à la série de trafic ; il n’y a rien à restreindre sur les deux autres.
Bonnes pratiques et pièges
Laissez End date vide dans tout workflow planifié. Une date de fin figée rapporte indéfiniment la même fenêtre, ce qui ressemble à un site à plat plutôt qu’à une configuration périmée.
Trois leviers de coût, par ordre d’effet : le regroupement, les séries que vous désactivez, et les colonnes de trafic. Les trois sont multiplicatifs, et les trois sont dans le panneau de réglages, à côté de votre solde d’unités restant.
Comment s’intègre-t-il dans un workflow ?
graph LR
Date[Date<br/>début de campagne] --> History[Ahrefs Domain History]
History -->|Change| LLM[LLM<br/>expliquer le mouvement]
History -->|Traffic history| Sheets[Google Sheets<br/>données du graphique]
LLM --> Docs[Google Docs<br/>rapport]