Referência
Relatório de backlinks do Ahrefs versus saída da API: uma referência de ações
Se você está acostumado a exportar um relatório de backlinks do Ahrefs, esta referência mostra quais partes você pode reconstruir a partir das nossas ações, quanto custa cada chamada e onde as grandes suítes se destacam.
Ações, preços e o que elas substituem em um relatório
| Ação | Créditos | Parte mais próxima de um relatório típico | Notas |
|---|---|---|---|
| domain, overview, stats, suggest | 0 | Contagens de títulos | Nenhuma chave necessária |
| bulk_dr | 1 | Uma coluna DR para uma lista | Até 2.000 domínios por chamada |
| compare | 1 | Domínios lado a lado | Até 20 domínios |
| top, dr_distribution, tld_breakdown | 1 | Gráficos de resumo | Resumos no estilo de distribuição |
| refdomains | 2 | Aba de domínios de referência | Paginado |
| backlinks | 2 | Aba de backlinks | Paginado |
| anchors, anchor_cloud | 2 | Aba de âncoras | A nuvem é para exibição |
| toppages | 2 | Melhores por links | Páginas que atraem links |
| intersect | 2 | Interseção de links | De 2 a 10 domínios |
| search, keyword | 3 | Sem correspondência direta | Pesquisa por âncora, título e URL |
Como as abas do relatório mapeiam para nossas ações
A maioria das exportações de relatórios vem em abas, e cada aba tem um equivalente aproximado aqui. Não é uma cópia exata. Leia o mapeamento como um ponto de partida, pois um campo que existe em uma aba pode não existir na nossa resposta.
A aba de domínios de referência
Imagine um relatório que abre com domínios de referência ordenados por DR. Nossa chamada mais próxima é refdomains, por 2 créditos, e pode ser ordenada da mesma forma. Espere renomear uma ou duas colunas no seu script, pois os nomes dos campos das linhas variam conforme a ação.
Corrija a ordenação entre meses. Uma lista ordenada por DR em um mês e por tráfego no próximo não pode ser comparada honestamente, então inclua a chave de ordenação no nome do arquivo.
A aba de âncoras e por que a nuvem é para exibição
anchors é a chamada para a aba de âncoras, por 2 créditos. anchor_cloud custa o mesmo, mas, como a tabela acima indica, é destinada à exibição. Se uma decisão depender de números, leia a lista simples.
Leia as âncoras com uma pergunta: um redator real digitaria essas palavras? Nomes de marca e URLs crus geralmente passam. Um bloco de frases monetárias idênticas repetidas em muitos domínios não passa, e esse bloco é a parte a ser verificada primeiro.
Páginas principais e a visualização de dois a dez domínios
toppages é o recurso mais próximo de uma aba de melhores por links. Ele mostra quais páginas atraem links, e isso muitas vezes diz mais do que um total de domínio quando uma mudança de classificação atinge uma pasta do site.
intersect aceita entre dois e dez domínios e custa 2 créditos por chamada. Digamos que você compare seu site com dois concorrentes. A sobreposição mostra então quais sites de linkagem os três compartilham, o que é simples e barato.
Parâmetros que se aplicam a todas as chamadas
Três coisas controlam todas as listas. São elas page, per e o par sort com order. Mantenha-os fixos entre os meses.
per aceita de 10 a 5000, embora uma chamada retorne até 1.000 linhas, e a paginação profunda pare em 50.000 linhas. Cada chamada é cobrada uma vez, independentemente da contagem de linhas, então solicitar uma página completa custa o mesmo que solicitar dez linhas.
A autenticação usa key=sk_... na query ou um cabeçalho Authorization: Bearer sk_.... O CORS é aberto, mas mantenha a chave no seu servidor, já que o código do navegador a expõe a todos os visitantes.
A ordem importa. Ao navegar pelos resultados, ordene por DR descendente para os domínios que provavelmente importam, ou ascendente para inspecionar a cauda longa de sites pequenos. Independentemente da escolha, anote-a ao lado do arquivo.
Trate a tabela acima como um mapa e as respostas salvas como o território. Se um campo que você esperava estiver ausente, construa em torno do que está disponível.
Uma exportação mensal, em cinco etapas
Execute as mesmas cinco etapas todos os meses, para que os arquivos salvos se alinhem ao compará-los.
- 1
Escolha as chamadas
Escolha
refdomains,anchorsetoppagespara cada domínio. Overview e stats são gratuitos, então adicione-os à mesma pasta. - 2
Defina a profundidade
Defina
page,per,sorteorderuma vez e mantenha-os. Per pode ir até 5000, mas uma única chamada retorna até 1.000 linhas. - 3
Salve cada resposta sem alterações
Grave o JSON bruto no disco antes de qualquer análise. Se um script falhar mais tarde, a cópia salva é o que você reexecutará.
- 4
Leia o objeto _credits
Cada resposta autenticada relata seu custo e o saldo restante. Copie ambos para uma linha de log, para que o gasto do mês fique visível sem um painel.
- 5
Compare com o mês anterior
Compare as cópias salvas. A receita de diff lista as três colunas que valem a pena manter.
Créditos, limites de linhas e a conta de um mês
A lista de preços é curta. A conta depende de com que frequência você faz chamadas e como pagina. Três hábitos decidem a maior parte disso.
Uma cobrança por chamada, independentemente das linhas
Cada chamada é cobrada uma vez, então per=1000 custa o mesmo que per=10 para a mesma ação. Uma página completa é a escolha barata para uma lista que você reutilizará, e a dispendiosa para uma consulta rápida.
Digamos que você extraia refdomains para um domínio no mesmo dia de cada mês. Isso são 2 créditos, ou $0,0002, por mês, na taxa publicada de $0,0001 por crédito.
O teto de 50.000 linhas
A paginação profunda para em 50.000 linhas. Um loop que continua solicitando a próxima página após isso não obterá nada novo, então limite a contagem de páginas antes do loop começar.
Alcançar o teto com 1.000 linhas por chamada requer cinquenta chamadas. A 2 créditos cada, isso são 100 créditos, ou $0,01. Barato, mas apenas se o script parar quando deve.
Um pequeno orçamento para um hábito mensal
Imagine dez domínios, cada um com refdomains e anchors extraídos uma vez por mês. Isso são 40 créditos por mês, ou $0,004, retirados dos $100 de crédito gratuito no cadastro, que equivalem a 1.000.000 créditos.
Nesse ritmo, o crédito gratuito dura muito tempo, e o log de gastos mostra se o ritmo se mantém. Mantenha-o.
Solução de problemas de respostas
| Você vê | Causa | Solução |
|---|---|---|
| HTTP 401 | Chave ausente ou incorreta | Verifique a chave e a grafia do cabeçalho |
| HTTP 402 | Os créditos acabaram | Recarregue em USDT (TRC-20) na página da conta |
| ok é falso | A solicitação foi rejeitada | Leia a mensagem no corpo e os parâmetros que você enviou |
| Menos linhas do que uma grande suíte mostra | Índice e tempo de rastreamento diferentes | Compare tendências, não totais |
| Um link que você criou na semana passada está faltando | Índice reconstruído aproximadamente mensalmente | Verifique novamente no próximo ciclo |
Uma linha ausente é uma pergunta, não uma resposta
Uma linha que desaparece entre duas respostas é uma surpresa comum. Antes de decidir o que isso significa, separe as histórias que ela poderia contar.
Três histórias por trás de uma linha faltando
O link pode nunca ter sido indexado, ou pode ter sido removido. A terceira história é de tempo: a página foi rastreada antes ou depois de uma reconstrução do índice, e a linha aparece em um ciclo posterior.
Uma chamada não pode separar essas histórias. Apenas uma segunda cópia tirada mais tarde, além de uma olhada na própria página, reduz a lista.
Pese a linha antes de persegui-la
Verifique o DR do domínio e a página de linkagem antes de qualquer outreach. Um link removido de um site fraco raramente altera um plano. Um link removido de uma página que atraiu leitores pode merecer uma nota ao seu proprietário. A tabela de suspeitos mostra onde uma linha faltante se encaixa entre as causas mais amplas.
Mover uma exportação para nossas chamadas
Posso exportar as mesmas colunas que o Ahrefs me dá?
Não uma para uma. Os campos das linhas variam conforme a ação, então abra uma resposta salva e mapeie os nomes você mesmo. A tabela acima nomeia a ação mais próxima para cada parte de um relatório, mas os nomes dos campos serão diferentes.
A API é mais barata que uma assinatura do Ahrefs?
A resposta depende do volume de chamadas. Nosso preço publicado é $0,10 por 1.000 chamadas de um crédito. O Ahrefs vende unidades de API dentro de assinaturas, a partir de $129 por mês para 200.000 unidades, com pelo menos 50 unidades por solicitação. Conte suas chamadas antes de decidir.
As exportações antigas ainda serão comparáveis às novas?
Apenas se a ordenação, a profundidade e a fonte coincidirem. Um arquivo extraído de uma ferramenta diferente em uma semana diferente é uma amostra diferente. Mantenha os arquivos antigos e inicie a nova série com um par claramente rotulado.
Preciso manter a chave no meu servidor?
Sim. O CORS é aberto, então um navegador pode chamar a API, mas uma chave no código front-end é visível para todos os visitantes. Envie solicitações do seu servidor e leia a chave de uma variável de ambiente.
Antes de construir um relatório com base nessas chamadas
- Abra uma resposta salva por ação e anote os nomes dos campos das linhas que você realmente recebe.
- Decida qual rótulo de mês vai para o nome de cada arquivo.
- Mantenha
page,per,sorteorderidênticos entre as extrações mensais. - Registre o objeto
_creditsde cada resposta autenticada para que o gasto por trabalho fique visível. - Limite a paginação profunda no seu script, já que as listas param em 50.000 linhas.
- Adicione uma nota de atualização a qualquer relatório que você entregar, dizendo que o índice é atualizado aproximadamente mensalmente.
Lendo o envelope
Cada resposta carrega ok. As autenticadas também adicionam _credits, para que você possa registrar o gasto por trabalho e acompanhar o saldo.
curl -s "https://rankele.com/api.php?action=toppages&q=example.com&per=50&key=sk_live_..." | head -c 600
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://rankele.com/api.php?action=bulk_dr&domains=example.com,example.org"O Ahrefs vende unidades de API dentro de assinaturas, a partir de $129 por mês para 200.000 unidades com 50 unidades mínimas por solicitação. Ele também oferece palavras-chave, rastreamento de classificação e um rastreamento mais recente, assim como o Semrush. Nós cobrimos dados de link por um preço baixo por chamada e nada além disso. Use o manual mensal se essa for a lacuna que você precisa preencher. A árvore de decisão de pico de spam é um bom primeiro uso das chamadas de resumo baratas.
