Introdução
Com a API da Ahrefs, você pode usar os dados da sua área de trabalho da Ahrefs para criar integrações e automações personalizadas. Atualmente, a API v3 permite extrair dados dos endpoints do Site Explorer, Keywords Explorer, Visão geral da SERP, Rank Tracker, Site Audit, Brand Radar e Social Media Management, além de gerenciar seus projetos do Rank Tracker e listas do Keywords Explorer:
- Site Explorer: Estatísticas gerais e gráficos históricos, Backlinks, relatórios de tráfego orgânico e pago
- Keywords Explorer: Métricas para uma única palavra-chave ou uma lista de palavras-chave, histórico de volume de pesquisa e volume por país, relatórios de ideias de palavras-chave
- Site Audit: Pontuações de integridade dos projetos, relatórios completos de problemas e conteúdo das páginas rastreadas
- Visão geral da SERP: 100 principais resultados da SERP
- Rank Tracker: Visão geral do projeto, relatórios de concorrentes e SERPs do Rank Tracker
- Batch Analysis: Métricas para até 100 alvos por solicitação
- Brand Radar: Estatísticas gerais da marca, gráficos históricos de desempenho e prompts reais com citações em vários agentes de IA
- Gerenciamento de redes sociais: Canais, publicações, histórico de atividades e métricas de contas de redes sociais conectadas
- Gerenciamento: Endpoints para gerenciar seus projetos do Rank Tracker e listas do Keywords Explorer
- Informações da assinatura: Seus limites e uso da API
- Endpoints públicos: Endereços IP e intervalos do nosso rastreador
Elegibilidade
A API da Ahrefs está disponível em planos pagos elegíveis. Em todos os outros planos, você ainda terá acesso a um conjunto limitado de consultas de teste gratuitas.
Limites do plano
Todas as solicitações, exceto as consultas de teste gratuitas e os endpoints Rank Tracker, Management, Public e alguns outros, consomem unidades de API. O custo depende do número de linhas na resposta e dos campos solicitados. O custo mínimo de qualquer solicitação é de 50 unidades. Se um endpoint for gratuito, você verá uma observação sobre isso na página de documentação; caso contrário, ele consome unidades.
Guia relacionado: Consumo de limites
info
Informamos que as unidades de API, uma vez consumidas, não são reembolsáveis. Recomendamos fortemente o uso das nossas consultas de teste gratuitas para todo desenvolvimento e teste, a fim de reduzir qualquer consumo não intencional de unidades de API.
Também recomendamos definir limites nas suas chaves de API, especialmente durante a fase de testes e desenvolvimento.
Os planos pagos elegíveis incluem uma franquia mensal de unidades de API. Nos planos que oferecem suporte ao uso com pagamento conforme o uso, unidades adicionais são cobradas automaticamente quando o limite incluído é ultrapassado.
Se você tem uma assinatura anual, pode economizar pagando antecipadamente por mais unidades de API com desconto. Você pode acompanhar o consumo de unidades de API e comprar adicionais pré-pagos em Configurações da conta / Limites e uso.
Veja também: Página de preços
Chaves de API
Para enviar solicitações para a API da Ahrefs, você precisará de uma chave de API. Apenas proprietários e administradores do workspace podem criar e gerenciar chaves de API. Isso pode ser feito em Configurações da conta / Chaves de API.
Guia relacionado: Criação e gerenciamento de chaves de API
Uso básico
Comece rapidamente com estes botões de API nos Relatórios da Ahrefs. Clique neles para exibir a solicitação como um comando cURL.
Esses botões podem ser usados como um construtor de consultas, já que o comando cURL será atualizado dinamicamente com quaisquer filtros que você aplicar ao relatório.
Observe que o cURL contém todos os campos e métricas exibidos no relatório atual. Você pode remover os campos de que não precisa para reduzir o custo de uma solicitação.
Para ver todos os detalhes de uso, consulte a referência da API nesta documentação. A referência contém uma especificação compatível com OpenAPI do formato de solicitação e resposta de cada endpoint.
Limitação de taxa
Por padrão, a API da Ahrefs é limitada a 60 solicitações por minuto. Se esse limite for excedido, a API responderá com o código de status HTTP 429 (Too Many Requests).
Além disso, para manter o desempenho ideal e a estabilidade do sistema, as solicitações à API podem ocasionalmente ser rejeitadas com o mesmo código de status HTTP 429 devido à limitação de taxa. A limitação de taxa ocorre de forma dinâmica com base na carga do sistema em tempo real, na disponibilidade de recursos e nas demandas computacionais das suas solicitações.