Fluxo de Trabalho de Pesquisa de Conteúdo
Planejamento de conteúdo com dados de tendências e sentimento usando endpoints da YepAPI.
Endpoints Utilizados
| Endpoint | Custo | Propósito |
|---|---|---|
POST /v1/seo/trends | $0.02 | Interesse do Google Trends ao longo do tempo (até 5 palavras-chave) |
POST /v1/seo/keywords/ideas | $0.03 | Sugestões de palavras-chave a partir de uma semente |
POST /v1/seo/keywords | $0.15 | Métricas em lote de palavras-chave (volume, CPC, dificuldade) |
POST /v1/seo/ai/chatgpt | $0.05 | O que o ChatGPT diz sobre uma consulta |
POST /v1/seo/ai/gemini | $0.05 | O que o Gemini diz sobre uma consulta |
Fluxo de Trabalho
Passo 1: Verificar Tendências
Execute POST /v1/seo/trends com palavras-chave do tópico.
{
"keywords": ["content marketing", "ai content", "seo strategy"]
}
Retorna: interesse ao longo do tempo para cada palavra-chave — identifique padrões sazonais e tópicos em ascensão.
Passo 2: Descobrir Ângulos de Conteúdo
Execute POST /v1/seo/keywords/ideas com uma palavra-chave semente.
{
"keyword": "content marketing",
"location": "us"
}
Retorna: sugestões de palavras-chave que você talvez não tenha considerado — cada uma é um ângulo potencial de conteúdo.
Passo 3: Avaliar Palavras-chave
Execute POST /v1/seo/keywords nas palavras-chave descobertas.
{
"keywords": ["content marketing strategy", "content marketing examples", "content marketing roi"],
"location": "us"
}
Retorna: volume de busca, CPC, dificuldade da palavra-chave, intenção de busca, tendências de 12 meses.
Passo 4: Verificar Visibilidade em IA
Execute POST /v1/seo/ai/chatgpt e POST /v1/seo/ai/gemini para ver o que a IA diz sobre o tópico.
{
"query": "best content marketing strategies"
}
Retorna: o que cada LLM atualmente diz — útil para entender o panorama de IA em torno do seu tópico.
Passo 5: Compilar Briefing de Conteúdo
Compile em um briefing de conteúdo:
- Palavra-chave alvo — maior oportunidade (volume vs. dificuldade)
- Palavras-chave de suporte — termos relacionados para incluir
- Direção da tendência — ascendente, estável ou descendente
- Panorama de IA — o que os LLMs atualmente dizem, lacunas a preencher
Regras
- Os dados de tendências mostram padrões sazonais — verifique picos futuros
- As verificações de visibilidade em IA revelam o que os LLMs atualmente dizem sobre um tópico (útil para SEO de IA)
- As ideias de palavras-chave fornecem ângulos de conteúdo que você talvez não tenha considerado
- Sempre verifique a dificuldade antes de se comprometer com uma palavra-chave — evite termos com DR 80+ para sites novos
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 de novo, 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