Referência
Referência: cada ação, quanto custa, como falha
Mantenha esta página aberta enquanto você scripta sua auditoria. Ela lista ações, preços, limites de paginação e os dois erros que você provavelmente encontrará.
Conceitos básicos antes das tabelas
O endpoint é https://backlinkphoenix.com/api.php?action=<action>&q=<domain>&key=sk_.... Você pode enviar a chave como um cabeçalho Bearer. O CORS está aberto, então um script no navegador também funciona.
Toda resposta possui um indicador ok. As respostas autenticadas também carregam _credits, que informa o custo e seu saldo restante. Isso torna o acompanhamento do orçamento trivial.
Em comparação com a precificação da API de backlinks do Moz, a estrutura é diferente: a Ahrefs vende unidades dentro de assinaturas a partir de $129 por mês para 200.000 unidades, enquanto aqui você paga por chamada a partir de um saldo pré-pago.
Não há nível de assinatura para subir nem mínimo mensal. Um saldo pré-pago significa que não há conta de excedente. Uma regra se aplica a todos. Um script que roda uma vez por mês e um script que roda em cada onboarding de cliente pagam pela mesma regra. Novos cadastros começam com $100 em crédito gratuito, o suficiente para aproximadamente 500.000 chamadas de dois créditos.
Escrevendo seu primeiro script sem surpresas
Comece pequeno. Um script que chama a API é simples de escrever e fácil de ultrapassar o orçamento. As regras abaixo mantêm a primeira versão honesta.
Limite a primeira execução a um domínio. Quando a saída parecer correta, amplie a lista em etapas e verifique o saldo entre cada etapa.
Páginas são a unidade de custo
Uma chamada é cobrada uma vez, independentemente do número de linhas retornadas. Uma página que você busca é outra chamada, portanto, navegar por uma lista grande custa uma cobrança por página.
Suponha que um site tenha 2.500 domínios referenciadores e você queira todos eles. Com o tamanho de página que você escolher, isso será algumas chamadas, e cada uma terá seu próprio custo. Conte as páginas antes de iniciar o loop. Escolha um tamanho de página que se adapte à pergunta, já que uma lista curta precisa de uma chamada e uma lista longa exige o mesmo cuidado em cada página.
Leia os créditos em cada resposta
Toda resposta autenticada carrega _credits, que informa quanto a chamada custou e o que restou. Registre esse campo em vez de um número que você estimou de cabeça.
Um script que grava o saldo em sua saída permite que você pare antes que uma execução longa esgote a conta. Mantenha a verificação simples e visível.
Use as chamadas gratuitas para testar o plano
domain, overview, stats e suggest não precisam de chave e não custam nada. Use-os para confirmar a ortografia do domínio e a forma básica dos dados antes que qualquer chamada paga seja executada.
Só então adicione as chamadas pagas, uma de cada vez, contra o mesmo domínio. Um erro capturado em uma chamada gratuita não custa nada. Mantenha as saídas gratuitas na mesma pasta datada das pagas.
Ações gratuitas e de um crédito
| Ação | Custo | Para que serve |
|---|---|---|
| domain | Grátis | Consulta rápida de DR, a chamada por trás do verificador na página inicial |
| overview | Grátis | Números principais para um domínio |
| stats | Grátis | Figuras sobre o próprio índice |
| suggest | Grátis | Consulta estilo autocompletar de domínios |
| bulk_dr | 1 crédito | Até 2.000 domínios por chamada, GET com domains= ou um corpo POST |
| compare | 1 crédito | Até 20 domínios lado a lado |
| top | 1 crédito | Uma lista classificada do nosso índice |
| dr_distribution | 1 crédito | Como o DR se distribui em um conjunto |
| tld_breakdown | 1 crédito | Referenciadores agrupados por TLD |
Ações de dois e três créditos
| Ação | Custo | Para que serve |
|---|---|---|
| refdomains | 2 créditos | Domínios que linkam para um alvo |
| backlinks | 2 créditos | Links individuais |
| anchors | 2 créditos | Lista de anchor text |
| toppages | 2 créditos | Páginas que atraem links |
| anchor_cloud | 2 créditos | Palavras de anchor text ponderadas pelo uso |
| intersect | 2 créditos | Quem linka para 2-10 domínios ao mesmo tempo, para busca de links de substituição |
| search | 3 créditos | Busca de texto completo sobre anchors, títulos e URLs |
| keyword | 3 créditos | Quem é linkado com um anchor exato |
Uma chamada é cobrada uma vez, independentemente do número de linhas, até 1.000 linhas por chamada. Use page e per (10-5000) para percorrer os resultados, ordene com sort mais order=asc|desc. A paginação profunda para em 50.000.
Erros que você pode ver
| Código HTTP | Significado | O que fazer |
|---|---|---|
| 401 | Chave ausente ou inválida | Verifique o parâmetro key ou o cabeçalho |
| 402 | Créditos esgotados | Recarregue com USDT (TRC-20) na página da conta |
Quando uma chamada falha e o que verificar primeiro
Dois erros cobrem a maioria das falhas na prática. Cada um tem uma correção diferente, então leia o código antes de alterar qualquer outra coisa.
Uma chamada falha ainda diz algo. Mantenha a URL da solicitação, o horário e o corpo da resposta no log, com a chave removida.
Um 401 significa que a chave não é aceita
Uma resposta 401 diz que a chave está ausente ou inválida. A correção está na solicitação, não nos dados. Verifique o parâmetro key ou o cabeçalho Bearer e certifique-se de que o valor foi copiado na íntegra. Nunca imprima a chave enquanto depura.
Suponha que um script funcione no seu laptop e falhe em um servidor. Um 401 lá muitas vezes significa que a variável de ambiente nunca foi definida nessa máquina.
Um 402 significa que o saldo esgotou
Uma resposta 402 significa que o crédito está gasto. Nada nos dados está errado, e repetir a mesma chamada falhará da mesma maneira até que você faça o recarga.
Recargas são feitas em USDT na rede TRC-20 na página da conta. Verifique o saldo antes de uma execução longa, para que o script não pare no meio de uma lista. Defina também um limite de aviso, já que um aviso antecipado é muito mais barato do que uma auditoria interrompida.
Retentativas sem desperdício
Retente apenas erros que podem mudar, como um timeout. Um 401 ou 402 retido em um loop adiciona ruído ao log e nenhum dado à auditoria.
Faça uma pausa entre as tentativas e mantenha o domínio que falhou em uma lista separada para que você possa executá-lo novamente de propósito, e não por acidente. Escreva a regra de retentativa em um comentário no início do script, para que a próxima edição a mantenha.
Qual ação para qual pergunta de recuperação
Corresponda a pergunta que você tem à chamada mais barata que a responda.
Qual é o tamanho do dano?
Comece com overview, que é gratuito. Depois, execute refdomains uma vez e compare com o arquivo que você salvou no mês passado. Nossa rotina mensal mostra o diff.
Como são os links junk?
Use anchors e anchor_cloud. Palavras estranhas que se repetem em muitos domínios são o padrão a ser capturado antes de abrir os mitos do disavow.
Quais doadores valem a pena perseguir?
intersect pega de dois a dez domínios e retorna sites que linkam para vários deles. Alimente seus concorrentes, procure doadores que pulem você, então classifique a lista com bulk_dr.
A mudança vazou?
toppages no domínio antigo e no novo mostra onde os links aterrissam. O tutorial de migração usa isso passo a passo.
Uma auditoria única em quatro chamadas
Esta ordem mantém as chamadas pagas poucas e cada uma vinculada a uma pergunta. Execute uma vez por domínio, depois repita as chamadas pagas mensalmente com as mesmas configurações.
Execute as chamadas gratuitas
Comece com overview e domain. Ambas são gratuitas e sua saída define a escala para todas as chamadas pagas que se seguem.
Puxe os domínios referenciadores
Use refdomains a 2 créditos por chamada. Conte as páginas primeiro, então decida quantas você precisará.
Verifique a mistura de anchors
Execute anchors ou anchor_cloud a 2 créditos cada. Procure palavras estranhas que se repetem em muitos domínios.
Classifique a lista de candidatos
Alimente os domínios questionáveis ao bulk_dr a 1 crédito por chamada, que lida com até 2.000 domínios. Mantenha as pontuações no mesmo arquivo dos domínios referenciadores.
Uma chamada paginada, anotada
Todos os parâmetros após a ação são opcionais.
curl "https://backlinkphoenix.com/api.php?action=toppages&q=yourshop.com&page=2&per=500&order=desc&key=sk_live_..."
# q: the domain; page and per: paging; order: asc or desc; key: your secret
# every response includes ok, and authenticated ones add _creditsUma comparação justa com uma alternativa à API de backlinks do Moz
Comparações justas começam com as mesmas unidades. Páginas de preços muitas vezes escondem a unidade, então anote o que você realmente paga por cada resposta antes de comparar totais.
Na Ahrefs, as unidades ficam dentro de uma assinatura, que começa em $129 por mês e compra 200.000 unidades. Cada solicitação usa pelo menos 50 delas. Esse é o detalhe. Coloque isso ao lado de um preço por chamada, e só então a comparação faz sentido.
Um teste igual para igual
Escolha cinco domínios de tamanho conhecido e execute as mesmas perguntas em ambos os serviços. Compare as respostas que você precisa, não os recursos que você admira.
Suponha que um serviço retorne domínios referenciadores em uma única chamada e outro precise de três. O custo por resposta então importa mais do que o preço de lista.
Precificação nas mesmas unidades
Converta tudo para custo por resposta. Nossas chamadas são precificadas em créditos a $0,0001 cada, então uma chamada de dois créditos custa $0,0002 e uma chamada gratuita não custa nada. Suponha que uma execução mensal use sete créditos. Isso é $0,0007, abaixo de um décimo de centavo.
Inclua o custo do desperdício, como retentativas após uma chamada falha. Uma chamada barata que falha frequentemente pode acabar mais cara do que uma mais cara que funciona na primeira vez.
Onde um pacote completo ainda vence
Pesquisa de palavras-chave, rastreamento de classificação e rastreamento diário ficam fora desta API. Se essas são suas perguntas, um pacote completo as responde melhor, e a comparação deve dizer isso.
Use o livro razão para a pergunta que ele responde bem: como o perfil de links mudou e quais doadores valem uma olhada mais de perto. Nomeie a lacuna em suas anotações, como sem dados de palavras-chave aqui, para que o próximo leitor não assuma que o livro razão cobre isso.
