YepAPI/skills

Fluxo de Trabalho de Pesquisa de Backlinks

Pesquisa de construção de links e auditoria de backlinks usando os endpoints da YepAPI.

Endpoints Utilizados

Endpoint	Custo	Finalidade
POST /v1/seo/backlinks/summary	$0.03	Métricas agregadas de backlinks e proporção dofollow
POST /v1/seo/referring-domains	$0.03	Domínios de referência com métricas de autoridade
POST /v1/seo/backlinks	$0.05	Backlinks individuais com texto âncora e tipo

Fluxo de Trabalho

Etapa 1: Resumo de Backlinks

Execute POST /v1/seo/backlinks/summary no alvo.

{
  "target": "example.com"
}

Retorna: total de backlinks, proporção dofollow, rank de domínio, contagem de domínios de referência.

Etapa 2: Domínios de Referência

Execute POST /v1/seo/referring-domains para obter domínios que linkam.

{
  "target": "example.com"
}

Retorna: domínios de referência com métricas de autoridade, status dofollow/nofollow.

Etapa 3: Backlinks Individuais

Execute POST /v1/seo/backlinks para dados detalhados de links.

{
  "target": "example.com"
}

Retorna: backlinks individuais com texto âncora, URL de origem, tipo de link, autoridade da página.

Etapa 4: Comparação com Concorrentes

Repita as etapas 1-2 para domínios concorrentes para encontrar oportunidades de interseção de links — domínios que linkam para concorrentes, mas não para o site do usuário.

Regras

• Resumo primeiro (mais barato, a $0.03) — fornece a visão geral
• Domínios de referência são mais acionáveis ​​do que backlinks brutos para construção de links
• Filtrar por links dofollow para alvos de construção de links
• Ordenar por autoridade de domínio para priorizar oportunidades de alto valor

Tratamento de Erros

• NO_CREDITS (402) — Informe ao usuário para adicionar créditos em https://yepapi.com/dashboard
• UPSTREAM_ERROR (502) — Tentar novamente uma vez; se falhar de novo, pule essa etapa e anote
• VALIDATION_ERROR (400) — Verifique o formato do alvo; use domínio simples ou URL completa
• RATE_LIMITED (429) — Aguarde e tente novamente; respeite o cabeçalho Retry-After