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.

Warning

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 :

AncreContenu
ChangeComparaison premier/dernier point, par métrique
Domain Rating historyLa série du DR
Referring domains historyLa série des domaines référents
Traffic historyLa série de trafic
HistoryLa 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 }
}
Note

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 :

  1. Ahrefs Domain History avec Start date 2026-01-01, Grouping monthly, Cache window 7d.
  2. L’ancre History alimente un node Merge With Template.
  3. Le résultat est écrit dans un document Google Docs.

Exemple 2 : mesure d’une campagne

Workflow :

  1. Ahrefs Domain History sur la fenêtre de campagne, Grouping weekly, Organic traffic désactivé.
  2. 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 :

  1. 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.
  2. Un Conditional Node compare l’évolution du trafic à un seuil.
  3. Un Email Sender prévient l’équipe quand il est franchi.

Exemple 4 : comparer la croissance des concurrents

Workflow :

  1. Un node Text liste les concurrents.
  2. Un Loop Node alimente l’entrée Target.
  3. Ahrefs Domain History renvoie chaque série.
  4. 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

Tip

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.

Warning

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]

Nodes associés