O que a conexão faz por você
Conectar sua própria chave do Ahrefs significa que os dados de SEO que buscamos para seus sites são obtidos com a sua conta do Ahrefs em vez da nossa. Você vê as mesmas métricas no seu painel, extraídas da sua própria assinatura.
Antes de começar
Um plano do Ahrefs que inclua acesso à API, e direitos de proprietário ou administrador no espaço de trabalho do Ahrefs — apenas eles podem criar chaves de API.
1. Crie a chave no Ahrefs
No Ahrefs, abra Account settings → API keys e crie uma chave. Cada chave dura um ano e depois para de funcionar; a página mostra a data de validade de cada chave. Você também pode limitar quantas unidades de API uma chave pode usar a cada mês na mesma página.
2. Conecte-a aqui
Abra Integrations no seu painel e escolha Connect an account. Selecione Your own SEO data como o grupo e Ahrefs como a conta, preencha API key e pressione Connect account.
Testamos o que você cola antes de salvar qualquer informação. Uma chave que não funciona nunca é armazenada, e a resposta informa o que estava errado com ela. Uma chave funcional é mantida criptografada em nosso cofre de segredos — nunca em nosso banco de dados — e nunca mais é exibida, nem mesmo para você.
O que acontece em seguida
- As verificações de autoridade e backlinks que realizamos para seus sites usam a sua chave, dentro da cota do seu plano, e deixam de usar a nossa. Não cobramos pelas verificações executadas com a sua chave.
- Se a sua chave for revogada ou a cota expirar, nós interrompemos o processo e avisamos você — nas telas onde as métricas aparecem — em vez de retornar silenciosamente para a nossa conta. Corrija a chave no provedor ou desconecte-a para voltar ao que seu plano inclui.
- As verificações ocorrem em seu cronograma normal; conectar uma chave não gera uma explosão de chamadas contra sua cota.
Se não conectar
Parou de funcionar após um ano. As chaves do Ahrefs expiram após doze meses. Crie uma nova e conecte-a.
As verificações param com uma mensagem de limite. O limite mensal de unidades de API da chave ou o limite do seu plano foi atingido. Aumente o limite em Account settings → API keys ou aguarde sua renovação.
Informa que a chave foi rejeitada. Quase sempre uma de três situações: um espaço ou quebra de linha copiado junto, uma chave expirada ou uma chave que foi revogada ou gerada novamente após você tê-la copiado. Crie uma nova chave e cole-a novamente.
Conecta, mas algo falha depois. A chave autentica, mas não possui uma permissão necessária para a ação. Crie uma nova chave com as permissões listadas acima, depois desconecte a conexão antiga e conecte a nova chave.
Desconectando
Abra Integrations, localize a conta e pressione Disconnect. Isso exclui a chave armazenada imediatamente. Tudo o que a estava utilizando para na próxima ação, e as telas que dependiam dela informam isso em vez de falharem silenciosamente.
A desconexão não desfaz o que já foi feito — registros, implantações ou configurações que alteramos na sua conta permanecem como estão. Se você suspeita que a própria chave possa ter vazado, revogue-a também no provedor; a desconexão remove a nossa cópia, não a deles.