Este artigo faz referência à versão antiga de nossa API (v2). Nossa versão mais recente da API (v3) foi lançada em 7 de setembro de 2022 e está disponível para usuários Enterprise.
Nota: Planos de API legados não podem mais ser adquiridos, e a API legada está programada para desativação em 1º de março de 2024. A API via Integrações também não funcionará mais a partir dessa data. A nova API já está disponível, somente no plano Enterprise.
Por favor, sinta-se à vontade para contatar o [email protected] para mais detalhes.
Este artigo destacará o básico de como criar uma solicitação de API com a ajuda do nosso Criador de Solicitações de API.
Primeiro, vamos dar uma olhada no próprio criador para ver quais opções ele contém:
Token - campo obrigatório. Deve ser gerado aqui.
Alvo - campo obrigatório. Deve ser um site, caminho ou URL para o qual você está solicitando dados.
Modo - campo obrigatório. Você pode escolher entre subdomínios, domínio, exato e prefixo. Temos uma explicação detalhada sobre a diferença entre todos esses modos em nosso vídeo.
De - campo obrigatório. Esta é uma função de API da qual você solicitará dados.
Limite (onde aplicável). Por padrão, está definido para 1.000 com um limite máximo de 5M linhas por solicitação. Nota: você será cobrado apenas pela quantidade exata de linhas retornadas.
Saída. Você pode escolher a saída para sua consulta. As opções disponíveis incluem: json (padrão), xml, php.
Mais Opções: o conjunto de opções disponíveis aqui variará dependendo da consulta de API escolhida.
Aqui você também pode definir os parâmetros "where/having", bem como escolher Order by e Order
Ao final, você verá uma consulta de API feita de acordo com as escolhas feitas acima.
Agora, vamos criar uma consulta de API simples seguindo o guia acima para obter backlinks para o domínio ahrefs.com (nota: todas as solicitações feitas com ahrefs.com e seus subdomínios como alvo são totalmente gratuitas, por isso fique à vontade para usar este domínio para seus testes).
Então, vamos lá:
Alvo: ahrefs.com
Modo: subdomínios
De: backlinks
Limite: 50
Saída: json
Onde: estamos verificando backlinks com a âncora “ahrefs”
Ordem por: Classificação de Domínio
Ordem: Desc (para obter os domínios com maior classificação de domínio primeiro)
O Criador de Solicitações de API fará o trabalho de codificar os dados e aqui está a consulta que obteremos com base na nossa entrada: https://apiv2.ahrefs.com/?token=XXX&target=ahrefs.com&limit=50&output=json&from=backlinks&mode=subdomains&where=title%3D%22ahrefs%22&order_by=domain_rating:desc
Assistir aos tutoriais: