Fluxo de Trabalho de SEO Local
Pesquisa de negócios locais usando dados do Google Maps e SERP local via endpoints da YepAPI.
Endpoints Utilizados
| Endpoint | Custo | Finalidade |
|---|---|---|
POST /v1/serp/google/maps | $0,01 | Resultados de empresas locais / Google Maps |
POST /v1/scrape | $0,01 | Extrair dados NAP de sites concorrentes |
POST /v1/seo/keywords | $0,15 | Métricas de palavras-chave locais (volume, dificuldade) |
POST /v1/seo/page-audit | $0,03 | Verificar sinais de SEO local no site do usuário |
Fluxo de Trabalho
Etapa 1: Descoberta de Concorrentes Locais
Execute POST /v1/serp/google/maps com a categoria de negócio + localização.
{
"query": "encanador em austin tx",
"location": "us"
}
Retorna: listagens de empresas locais com avaliações, contagens de comentários, categorias, endereços.
Etapa 2: Extrair Dados NAP
Para cada concorrente, execute POST /v1/scrape no site deles.
{
"url": "https://concorrente-encanador.com",
"format": "markdown"
}
Extraia dados NAP (Nome, Endereço, Telefone) para comparar consistência entre as listagens.
Etapa 3: Pesquisa de Palavras-chave Locais
Execute POST /v1/seo/keywords com palavras-chave locais.
{
"keywords": ["encanador em austin", "encanador emergência austin tx", "serviço de encanamento austin"],
"location": "us"
}
Retorna: volume de pesquisa local, CPC, dificuldade — palavras-chave locais têm menor volume, mas maior intenção.
Etapa 4: Auditoria na Página
Execute POST /v1/seo/page-audit no site do usuário.
{
"url": "https://exemplo-encanador.com"
}
Verifique sinais de SEO local: dados estruturados (esquema LocalBusiness), consistência NAP, palavras-chave de localização em meta tags.
Etapa 5: Apresentar Descobertas
- Cenário de concorrentes locais (avaliações, contagens de comentários, rankings)
- Oportunidades de palavras-chave (termos locais com volume e dificuldade)
- Correções na página (dados estruturados ausentes, inconsistências NAP, lacunas em meta tags)
Regras
- Inclua sempre a localização nas consultas do Maps — os resultados dependem da localização
- A consistência NAP é crítica para SEO local — sinalize discrepâncias
- Os resultados do Google Maps incluem avaliações, contagens de comentários e categorias — use para benchmarking de concorrentes
- Palavras-chave locais têm menor volume, mas maior intenção — priorize o potencial de conversão
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 consulta; inclua a localização na string de consultaRATE_LIMITED(429) — Aguarde e tente novamente; respeite o cabeçalhoRetry-After