Flujo de Trabajo SEO Local
Investigación de negocios locales utilizando datos de Google Maps y SERP local a través de los endpoints de YepAPI.
Endpoints Utilizados
| Endpoint | Costo | Propósito |
|---|---|---|
POST /v1/serp/google/maps | $0.01 | Resultados de Google Maps / negocios locales |
POST /v1/scrape | $0.01 | Extraer sitios web de competidores para datos NAP |
POST /v1/seo/keywords | $0.15 | Métricas de palabras clave locales (volumen, dificultad) |
POST /v1/seo/page-audit | $0.03 | Verificar señales SEO locales en el sitio del usuario |
Flujo de Trabajo
Paso 1: Descubrimiento de Competidores Locales
Ejecuta POST /v1/serp/google/maps con categoría de negocio + ubicación.
{
"query": "plumber in austin tx",
"location": "us"
}
Devuelve: listados de negocios locales con calificaciones, recuento de reseñas, categorías, direcciones.
Paso 2: Extraer Datos NAP
Para cada competidor, ejecuta POST /v1/scrape en su sitio web.
{
"url": "https://competitor-plumber.com",
"format": "markdown"
}
Extrae los datos NAP (Nombre, Dirección, Teléfono) para comparar la consistencia entre listados.
Paso 3: Investigación de Palabras Clave Locales
Ejecuta POST /v1/seo/keywords con palabras clave locales.
{
"keywords": ["plumber in austin", "emergency plumber austin tx", "austin plumbing service"],
"location": "us"
}
Devuelve: volumen de búsqueda local, CPC, dificultad — las palabras clave locales tienen menor volumen pero mayor intención.
Paso 4: Auditoría en Página
Ejecuta POST /v1/seo/page-audit en el sitio del usuario.
{
"url": "https://example-plumber.com"
}
Verifica señales SEO locales: datos estructurados (esquema LocalBusiness), consistencia NAP, palabras clave de ubicación en metaetiquetas.
Paso 5: Presentar Hallazgos
- Panorama de competidores locales (calificaciones, recuento de reseñas, posiciones)
- Oportunidades de palabras clave (términos locales con volumen y dificultad)
- Correcciones en página (datos estructurados faltantes, inconsistencias NAP, brechas en metaetiquetas)
Reglas
- Siempre incluye la ubicación en las consultas de Maps — los resultados dependen de la ubicación
- La consistencia NAP es crítica para el SEO local — señala las discrepancias
- Los resultados de Google Maps incluyen calificaciones, recuento de reseñas y categorías — úsalos para comparar competidores
- Las palabras clave locales tienen menor volumen pero mayor intención — prioriza el potencial de conversión
Manejo de Errores
NO_CREDITS(402) — Indica al usuario que agregue créditos en https://yepapi.com/dashboardUPSTREAM_ERROR(502) — Reintenta una vez; si falla de nuevo, omite ese paso y anótaloVALIDATION_ERROR(400) — Verifica el formato de la consulta; incluye la ubicación en la cadena de consultaRATE_LIMITED(429) — Espera y reintenta; respeta el encabezadoRetry-After