Utilisez votre propre clé Ahrefs pour les métriques SEO de vos sites

Ce que cette connexion vous apporte

Connecter votre propre clé Ahrefs signifie que les données SEO que nous récupérons pour vos sites sont récupérées avec votre compte Ahrefs au lieu du nôtre. Vous voyez les mêmes indicateurs dans votre tableau de bord, tirés de votre propre abonnement.

Avant de commencer

Un forfait Ahrefs incluant l’accès à l’API, ainsi que des droits de propriétaire ou d’administrateur sur l’espace de travail Ahrefs — seuls ces rôles peuvent créer des clés d’API.

1. Créez la clé sur Ahrefs

Dans Ahrefs, ouvrez Paramètres du compte → Clés d’API et créez une clé. Chaque clé est valable un an puis cesse de fonctionner ; la page affiche la date d’expiration de chaque clé. Vous pouvez également plafonner le nombre d’unités d’API qu’une clé peut consommer chaque mois sur cette même page.

2. Connectez-la ici

Ouvrez Intégrations dans votre tableau de bord et choisissez Connecter un compte. Sélectionnez Vos propres données SEO comme groupe et Ahrefs comme compte, renseignez Clé d’API, puis appuyez sur Connecter le compte.

Nous testons ce que vous collez avant que quoi que ce soit ne soit enregistré. Une clé qui ne fonctionne pas n’est jamais stockée, et la réponse indique ce qui n’allait pas. Une clé fonctionnelle est conservée chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et n’est plus jamais affichée, même pas à vous.

Que se passe-t-il ensuite

• Les vérifications d’autorité et de backlinks que nous exécutons pour vos sites utilisent votre clé, sur le quota de votre forfait, et cessent d’utiliser la nôtre. Nous ne vous facturons pas les vérifications exécutées sur votre clé.
• Si votre clé est révoquée ou si son quota est épuisé, nous nous arrêtons et vous le signalons — sur les écrans où les indicateurs apparaissent — plutôt que de rebasculer silencieusement sur notre compte. Corrigez la clé chez le fournisseur, ou déconnectez-la pour revenir à ce que comprend votre forfait.
• Les vérifications s’exécutent selon leur calendrier habituel ; connecter une clé ne déclenche pas une vague d’appels imputée sur votre quota.

Si la connexion ne s’établit pas

Elle a cessé de fonctionner après un an. Les clés Ahrefs expirent au bout de douze mois. Créez-en une nouvelle et connectez-la.

Les vérifications s’arrêtent avec un message de limite. Le plafond mensuel d’unités d’API de la clé, ou le forfait alloué, est épuisé. Augmentez le plafond dans Paramètres du compte → Clés d’API, ou attendez son renouvellement.

Le système indique que la clé a été rejetée. Il s’agit presque toujours de l’une de ces trois situations : un espace ou un saut de ligne copié avec la clé, une clé expirée, ou une clé révoquée ou régénérée après l’avoir copiée. Créez-en une nouvelle et collez-la à nouveau.

Elle se connecte, mais une action échoue par la suite. La clé s’authentifie mais ne dispose pas d’une autorisation requise par l’action. Créez une nouvelle clé avec les autorisations listées ci-dessus, puis déconnectez l’ancienne connexion et connectez la nouvelle clé.

Déconnexion

Ouvrez Intégrations, trouvez le compte et appuyez sur Déconnecter. Cela supprime immédiatement la clé stockée. Tout élément qui l’utilisait s’arrête à sa prochaine action, et les écrans qui en dépendaient le précisent au lieu d’échouer silencieusement.

La déconnexion n’annule pas ce qui a déjà été effectué — les enregistrements, déploiements ou paramètres que nous avons modifiés sur votre compte restent tels quels. Si vous pensez que la clé elle-même a pu fuiter, révoquez-la également chez le fournisseur ; la déconnexion supprime notre copie, pas la leur.