Pesquisa de Concorrentes (YepAPI)

Workflow de Pesquisa de Concorrentes

Análise competitiva entre domínios utilizando os endpoints da API YepAPI.

Endpoints Utilizados

Endpoint	Custo	Propósito
POST /v1/seo/domain/overview	$0.01	Tráfego, palavras-chave, backlinks, ranking do domínio
POST /v1/seo/competitors	$0.04	Domínios concorrentes SEO por sobreposição de palavras-chave
POST /v1/seo/keyword-gap	$0.04	Análise de lacunas de palavras-chave entre dois domínios

Workflow

Etapa 1: Visão Geral do Domínio

Execute POST /v1/seo/domain/overview no domínio do usuário.

{
  "domain": "exemplo.com"
}

Retorna: tráfego orgânico, total de palavras-chave, contagem de backlinks, ranking do domínio.

Etapa 2: Descobrir Concorrentes

Execute POST /v1/seo/competitors no domínio do usuário.

{
  "domain": "exemplo.com"
}

Retorna: domínios concorrentes com percentual de sobreposição de palavras-chave e estimativas de tráfego.

Etapa 3: Comparar Principais Concorrentes

Para os 2-3 principais concorrentes, execute POST /v1/seo/domain/overview em cada um.

{
  "domain": "concorrente.com"
}

Compare: tráfego, contagens de palavras-chave, perfis de backlinks, ranking do domínio.

Etapa 4: Análise de Lacunas de Palavras-chave

Execute POST /v1/seo/keyword-gap entre o domínio do usuário e o principal concorrente.

{
  "domain": "exemplo.com",
  "competitor": "concorrente.com"
}

Retorna: palavras-chave que o concorrente ranqueia e o usuário não — ordenadas por volume e dificuldade.

Etapa 5: Apresentar Resultados

• Quem está vencendo no geral (tráfego, autoridade)
• Onde estão as lacunas de palavras-chave (termos de alto valor que o usuário está perdendo)
• O que atacar em seguida (priorizado por oportunidade: alto volume + baixa dificuldade)

Regras

• Comece com a visão geral do domínio — a mais barata a $0.01, fornece métricas de base
• Limite análises aprofundadas de concorrentes aos 3 principais — controla custos
• A análise de lacunas de palavras-chave é o resultado mais acionável — sempre inclua-a

Tratamento de Erros

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