Fluxo de Trabalho de Pesquisa de Palavras-chave
Fluxo de trabalho dedicado à pesquisa de palavras-chave — descubra, avalie e priorize palavras-chave usando os endpoints da YepAPI.
Endpoints Utilizados
| Endpoint | Custo | Finalidade |
|---|---|---|
POST /v1/seo/keywords/ideas | $0,03 | Sugestões de palavras-chave a partir de uma palavra-chave semente |
POST /v1/seo/keywords/related | $0,03 | Palavras-chave relacionadas a uma palavra-chave semente |
POST /v1/seo/keywords | $0,15 | Métricas de palavras-chave em massa (volume, CPC, dificuldade, intenção) |
POST /v1/seo/keyword-gap | $0,04 | Análise de lacunas de palavras-chave entre dois domínios |
Fluxo de Trabalho
Passo 1: Gerar Ideias de Palavras-chave
Comece com uma palavra-chave semente. Execute POST /v1/seo/keywords/ideas.
{
"keyword": "gerenciamento de projetos",
"location": "br"
}
Retorna: sugestões de palavras-chave baseadas na semente — ângulos de conteúdo e variações de cauda longa.
Passo 2: Encontrar Palavras-chave Relacionadas
Expanda com POST /v1/seo/keywords/related.
{
"keyword": "gerenciamento de projetos",
"location": "br"
}
Retorna: termos semanticamente relacionados — variações mais amplas e mais específicas.
Passo 3: Avaliar Métricas das Palavras-chave
Execute POST /v1/seo/keywords com todas as palavras-chave candidatas.
{
"keywords": ["software de gerenciamento de projetos", "ferramentas de gerenciamento de projetos", "melhor aplicativo de gerenciamento de projetos"],
"location": "br"
}
Retorna: volume de busca, CPC, dificuldade da palavra-chave, intenção de busca (informacional/comercial/transacional), tendências de 12 meses.
Passo 4: Análise de Lacunas de Palavras-chave (Opcional)
Se o usuário tiver um domínio e um concorrente, execute POST /v1/seo/keyword-gap.
{
"domain": "exemplo.com.br",
"competitor": "concorrente.com.br"
}
Retorna: palavras-chave para as quais o concorrente ranqueia, mas o usuário não — oportunidades não exploradas.
Passo 5: Priorizar Palavras-chave
Apresente uma lista de palavras-chave priorizadas, ordenadas por pontuação de oportunidade:
- Alta oportunidade — alto volume + baixa dificuldade
- Agrupar por intenção — informacional, navegacional, comercial, transacional
- Sinalizar palavras-chave sazonais — observe padrões de 12 meses a partir dos dados de tendências
Regras
- Comece amplo com ideias, depois restrinja com métricas
- Agrupe palavras-chave por intenção de busca: informacional, navegacional, comercial, transacional
- Sinalize palavras-chave sazonais usando dados de tendências (padrão de 12 meses)
- Faça chamadas de métricas em lote — até 100 palavras-chave por requisição ($0,15) é mais barato do que consultas individuais
Tratamento de Erros
NO_CREDITS(402) — Informe ao usuário para adicionar créditos em https://yepapi.com/dashboardUPSTREAM_ERROR(502) — Tente novamente uma vez; se falhar novamente, pule essa etapa e anoteVALIDATION_ERROR(400) — Verifique o formato da palavra-chave; palavras-chave devem ser strings não vaziasRATE_LIMITED(429) — Aguarde e tente novamente; respeite o cabeçalhoRetry-After