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

Ce que cela vous apporte

Connecter votre propre clé Ahrefs signifie que les données SEO que nous récupérons pour vos sites le sont avec votre compte Ahrefs et non le nôtre. Vous visualisez les mêmes métriques dans votre tableau de bord, issues de votre propre abonnement.

Avant de commencer

Un abonnement 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 permettent de créer des clés API.

1. Créer la clé sur Ahrefs

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

2. La connecter 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, saisissez la clé API, puis cliquez sur Connecter le compte.

Nous testons ce que vous collez avant qu'un enregistrement ne soit effectué. Une clé qui ne fonctionne pas n'est jamais stockée, et le message indique ce qui n'allait pas. Une clé valide est conservée de manière chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et n'est plus jamais affichée, pas même pour vous.

Que se passe-t-il ensuite ?

• Les vérifications d'autorité et de liens retour que nous effectuons pour vos sites utilisent votre clé, sur le quota de votre abonnement, et n'utilisent plus le nôtre. Nous ne vous facturons pas les vérifications exécutées avec votre clé.
• Si votre clé est révoquée ou que son quota est épuisé, nous interrompons l'opération et vous en informons — sur les écrans où les métriques apparaissent — plutôt que de basculer discrètement sur notre compte. Corrigez la clé auprès du fournisseur, ou déconnectez-la pour revenir à ce que votre abonnement inclut.
• Les vérifications s'exécutent selon leur calendrier habituel ; connecter une clé ne déclenche pas un pic d'appels sur votre quota.

En cas de problème de connexion

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 API de la clé, ou le quota de votre abonnement, est épuisé. Augmentez le plafond dans Paramètres du compte → Clés API, ou attendez son renouvellement.

Le message indique que la clé a été rejetée. C'est presque toujours l'une de ces trois causes : 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 que vous l'avez copiée. Créez une nouvelle clé et collez-la à nouveau.

La connexion réussit, mais une action ultérieure échoue. La clé s'authentifie mais ne dispose pas d'une autorisation requise par l'action. Créez une nouvelle clé dotée des 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 cliquez sur Déconnecter. Cela supprime immédiatement la clé stockée. Tout processus qui l'utilisait s'arrête lors de sa prochaine action, et les écrans qui en dépendaient l'indiquent clairement au lieu d'échouer silencieusement.

La déconnexion n'annule pas ce qui a déjà été fait : les enregistrements, déploiements ou paramètres que nous avons modifiés sur votre compte restent inchangés. Si vous pensez que la clé elle-même a pu être compromise, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la leur.