Flujo de trabajo de investigación de palabras clave
Flujo de trabajo dedicado a la investigación de palabras clave: descubre, evalúa y prioriza términos utilizando los endpoints de YepAPI.
Endpoints utilizados
| Endpoint | Costo | Propósito |
|---|---|---|
POST /v1/seo/keywords/ideas | $0.03 | Sugerencias de palabras clave a partir de una palabra clave semilla |
POST /v1/seo/keywords/related | $0.03 | Palabras clave relacionadas para una palabra clave semilla |
POST /v1/seo/keywords | $0.15 | Métricas masivas de palabras clave (volumen, CPC, dificultad, intención) |
POST /v1/seo/keyword-gap | $0.04 | Análisis de brechas de palabras clave entre dos dominios |
Flujo de trabajo
Paso 1: Generar ideas de palabras clave
Comienza con una palabra clave semilla. Ejecuta POST /v1/seo/keywords/ideas.
{
"keyword": "gestión de proyectos",
"location": "us"
}
Devuelve: sugerencias de palabras clave basadas en la semilla — ángulos de contenido y variaciones de cola larga.
Paso 2: Encontrar palabras clave relacionadas
Expande con POST /v1/seo/keywords/related.
{
"keyword": "gestión de proyectos",
"location": "us"
}
Devuelve: términos semánticamente relacionados — variaciones más amplias y más específicas.
Paso 3: Evaluar métricas de palabras clave
Ejecuta POST /v1/seo/keywords con todas las palabras clave candidatas.
{
"keywords": ["software de gestión de proyectos", "herramientas de gestión de proyectos", "mejor app de gestión de proyectos"],
"location": "us"
}
Devuelve: volumen de búsqueda, CPC, dificultad de la palabra clave, intención de búsqueda (informativa/comercial/transaccional), tendencias a 12 meses.
Paso 4: Análisis de brechas de palabras clave (opcional)
Si el usuario tiene un dominio y un competidor, ejecuta POST /v1/seo/keyword-gap.
{
"domain": "ejemplo.com",
"competitor": "competidor.com"
}
Devuelve: palabras clave para las que el competidor rankea y el usuario no — oportunidades no aprovechadas.
Paso 5: Priorizar palabras clave
Presenta una lista de palabras clave priorizadas ordenadas por puntuación de oportunidad:
- Alta oportunidad — alto volumen + baja dificultad
- Agrupar por intención — informativa, navegacional, comercial, transaccional
- Marcar palabras clave estacionales — observar patrones de 12 meses a partir de los datos de tendencias
Reglas
- Comienza amplio con ideas, luego reduce con métricas
- Agrupa palabras clave por intención de búsqueda: informativa, navegacional, comercial, transaccional
- Marca palabras clave estacionales usando datos de tendencias (patrón de 12 meses)
- Realiza llamadas masivas de métricas de palabras clave — hasta 100 palabras clave por solicitud ($0.15) es más económico que consultas individuales
Manejo de errores
NO_CREDITS(402) — Indica al usuario que añada créditos en https://yepapi.com/dashboardUPSTREAM_ERROR(502) — Reintenta una vez; si falla de nuevo, salta ese paso y anótaloVALIDATION_ERROR(400) — Verifica el formato de la palabra clave; las palabras clave deben ser cadenas no vacíasRATE_LIMITED(429) — Espera y reintenta; respeta la cabeceraRetry-After