Ahrefs Organic Keywords

Le node Ahrefs Organic Keywords lit les mots-clés sur lesquels un domaine est positionné dans un pays, avec position, volume de recherche, page d'atterrissage et trafic estimé, sous un budget de lignes qui plafonne le coût API.

Que fait le node Ahrefs Organic Keywords ?#

Le node Ahrefs Organic Keywords lit les mots-clés sur lesquels un domaine est positionné dans un pays, avec leur position, leur volume de recherche, leur page d’atterrissage et le trafic estimé. Il accepte une expression de filtre Ahrefs, un tri et un budget de lignes.

C’est le node le plus coûteux du connecteur, et la raison d’être du cache. Ahrefs facture organic-keywords à la ligne renvoyée et à la colonne sélectionnée : une lecture négligente d’un gros domaine est le premier poste de la facture.

Trois valeurs par défaut gardent cela sous contrôle — cinq colonnes, une limite de 100 lignes et une fenêtre de cache de 24 heures — et le node rapporte ce qu’il a réellement dépensé, pour que l’arbitrage soit visible et non théorique. Une lecture tronquée le dit : une liste de mots-clés qui a l’air complète sans l’être, c’est ainsi qu’un rapport sous-estime un site d’un ordre de grandeur.

Cas d’usage courants :

• Trouver les mots-clés qui apportent son trafic à un site.
• Auditer l’empreinte mots-clés d’un concurrent.
• Extraire les meilleures pages d’atterrissage par trafic organique.
• Bâtir une liste de gains rapides à partir des mots-clés positionnés entre la 11e et la 20e place.
• Alimenter un plan de contenu avec de vrais volumes de recherche.

Mise en place rapide#

Paramètres de configuration#

Champs obligatoires#

Champs optionnels#

Colonnes par défaut#

Colonne	Contenu
keyword	Le terme de recherche
best_position	Meilleure position du domaine sur ce terme
volume	Volume de recherche mensuel
best_position_url	La page qui se positionne
sum_traffic	Visites mensuelles estimées depuis ce mot-clé

Ces cinq colonnes répondent à « quel mot-clé, à quelle position, quel volume, sur quelle page, pour combien de trafic », qui est la question d’un rapport. D’autres sont disponibles et facturées à la ligne, dont keyword_difficulty, cpc, is_branded, is_commercial, is_informational, is_navigational, is_transactional, is_local, serp_features, words, language, last_update, sum_paid_traffic, volume_desktop_pct et volume_mobile_pct.

Que renvoie le node ?#

Ancre	Contenu
Keywords	Les lignes de mots-clés seules, prêtes pour une liste, une feuille ou un Loop Node
Summary	Compteurs, indicateur de troncature, colonnes lues et unités dépensées

{
  "target": "example.com",
  "mode": "domain",
  "country": "us",
  "date": "2026-10-21",
  "columns": ["keyword", "best_position", "volume", "best_position_url", "sum_traffic"],
  "keywords": [
    {
      "keyword": "best seo tools",
      "best_position": 3,
      "volume": 12000,
      "best_position_url": "https://example.com/seo-tools",
      "sum_traffic": 2400
    }
  ],
  "keyword_count": 100,
  "complete": false,
  "truncated": true,
  "hit_row_cap": false,
  "requested_limit": 100,
  "truncation_notice": "Read 100 of the matching keywords and stopped at the requested limit of 100. Ahrefs bills per returned row, so the read does not continue on its own: raise the limit, or narrow the set with a filter.",
  "retrieved_at": "2026-10-21T16:04:11Z",
  "source": "Ahrefs API v3 (Site Explorer)",
  "cache": { "requests": 1, "cached_requests": 0, "units_cost": 150 }
}

Exemples d’utilisation#

Exemple 1 : les meilleurs mots-clés d’un domaine#

Workflow :

1. Un node Url fournit le domaine.
2. Ahrefs Organic Keywords avec Country us, Sort by sum_traffic:desc, Row limit 100 et Cache window 7d.
3. L’ancre Keywords est écrite dans un onglet Google Sheets.

Exemple 2 : liste de gains rapides#

Les mots-clés positionnés juste derrière la première page, là où un petit gain de position rapporte le plus.

Workflow :

1. Ahrefs Organic Keywords avec un Filter gardant best_position entre 11 et 20, Columns keyword, best_position, volume, keyword_difficulty, best_position_url, Sort by volume:desc, Row limit 200.
2. L’ancre Keywords alimente un LLM chargé de prioriser la liste.

Filtrer en amont coûte moins cher que filtrer en aval : les lignes qu’Ahrefs ne renvoie jamais ne sont jamais facturées.

Exemple 3 : empreinte d’un concurrent#

Workflow :

1. Un node Text liste les concurrents.
2. Un Loop Node alimente l’entrée Target.
3. Ahrefs Organic Keywords avec Row limit 50 et trois colonnes.
4. Un Merge With Template assemble la comparaison.

Exemple 4 : plan de contenu fondé sur la demande réelle#

Workflow :

1. Ahrefs Organic Keywords renvoie la liste de mots-clés.
2. Un Loop Node parcourt l’ancre Keywords — les lignes seules, sans enveloppe à déballer d’abord.
3. Un LLM rédige un brief par mot-clé.
4. Un node Google Docs les enregistre.

Problèmes courants#

`complete` vaut false et le résultat paraît court

Cause : La lecture a rempli son budget de lignes. Elle ne continue pas d’elle-même, car chaque ligne supplémentaire serait facturée.

Solution : Augmentez Row limit, ou restreignez l’ensemble avec un Filter pour que les lignes voulues tiennent dans le budget. truncation_notice indique laquelle des deux.

`hit_row_cap` vaut true

Cause : Un plafond dur de 10000 lignes par exécution a arrêté la lecture, quelle que soit la limite configurée.

Solution : Découpez la lecture — par pays, par préfixe de chemin, ou avec un filtre. Ce plafond existe pour qu’une cible mal saisie ne se transforme pas en facture à cinq chiffres.

`Ahrefs organic-keywords has no column ...`

Cause : Un nom de colonne qui n’existe pas sur cet endpoint, le plus souvent un quasi-homonyme comme position au lieu de best_position ou url au lieu de best_position_url.

Solution : L’erreur énumère toutes les colonnes disponibles. Rien n’a été appelé, donc rien n’a été facturé.

`The Ahrefs keyword limit is capped at 10000 rows per run`

Cause : La limite configurée dépasse le plafond dur.

Solution : Abaissez-la, et découpez la lecture si vous avez réellement besoin de plus de lignes.

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 dans le panneau de réglages. Le node ne réessaie jamais un appel, parce qu’un appel parvenu à Ahrefs a peut-être déjà été facturé. Baissez la limite, restreignez les colonnes, ou élargissez la fenêtre de cache.

Bonnes pratiques et pièges#

Comment s’intègre-t-il dans un workflow ?#

graph LR
    Url[Url<br/>domaine cible] --> Keywords[Ahrefs Organic Keywords]
    Keywords -->|Keywords| Loop[Loop Node]
    Loop --> LLM[LLM<br/>brief par mot-clé]
    Keywords -->|Summary| Check{complete ?}
    LLM --> Docs[Google Docs]

Nodes associés#