API rank tracker
La API de seguimiento de posiciones para Google y la búsqueda con IA
Lleva las posiciones de tus keywords en Google y las menciones de tu marca en ChatGPT, Perplexity, Claude, AI Overviews y el Modo IA a tus propios paneles, informes y procesos.
90 operaciones REST, una clave de API y los mismos datos que la aplicación.
curl "https://api.mencoro.com/api/v1/organizations/$MENCORO_ORG_ID/projects/$PROJECT_ID/keyword-listings?engines=google_serp,chatgpt,google_ai_overview&sortBy=shareOfVoice&sortOrder=desc&limit=1" \ -H "Authorization: Bearer $MENCORO_API_KEY"
{
"items": [
{
"keyword": "mejor crm para startups",
"engines": ["chatgpt", "google_ai_overview", "google_serp"],
"countries": ["ES"],
"lastCheckedAt": "2026-09-30T06:12:44Z",
"avgSerpPosition": 4.2,
"trendSerp": 1.3,
"mentionRate": 67,
"avgMentionPosition": 2.1,
"shareOfVoice": 31.5,
"trendShareOfVoice": 4.8
}
],
"total": 148
} Posiciones en Google y menciones en IA para cada keyword
Una sola llamada devuelve una fila por keyword con su posición media en Google, la tendencia frente al periodo anterior, con qué frecuencia te nombra cada motor de IA, en qué lugar de la respuesta y tu cuota de voz frente a los competidores que sigues. Filtra por motor, país, clúster o texto, ordena por cualquier métrica y pide CSV con la cabecera Accept cuando las filas vayan directas a una hoja de cálculo.
curl "https://api.mencoro.com/api/v1/organizations/$MENCORO_ORG_ID/projects/$PROJECT_ID/tracked-queries/$TRACKED_QUERY_ID/timeseries?dateFrom=2026-09-01&dateTo=2026-09-30&granularity=weekly" \ -H "Authorization: Bearer $MENCORO_API_KEY"
{
"points": [
{
"rawDate": "2026-09-21",
"brand": {
"serp": 3,
"mention": 2,
"mentionRate": 67,
"positivity": 82,
"shareOfVoice": 29.4
},
"competitors": { "…": "los mismos campos por competidor" }
}
]
} Histórico diario de posiciones, con la competencia en el mismo eje
Cada consulta seguida guarda su histórico: posición orgánica y en Shopping de Google, posición de la mención, posición del enlace, tasa de mención, sentimiento y cuota de voz, agrupado por día, semana o mes. Añade los ids de tus competidores y cada punto trae también sus cifras, así que un gráfico de quién ha ganado terreno es una sola petición. Las posiciones empiezan en 1 y un null significa que ese día no se capturó nada, nunca un cero.
curl -X POST "https://api.mencoro.com/api/v1/organizations/$MENCORO_ORG_ID/projects/$PROJECT_ID/tracked-queries" \
-H "Authorization: Bearer $MENCORO_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"queryTexts": ["mejor crm para startups", "crm con automatización de email"],
"engines": ["google_serp", "chatgpt", "perplexity"],
"countries": ["ES", "MX"],
"locale": "es",
"checkFrequency": "daily",
"nPasses": 1,
"queryClusterIds": []
}' Añade y programa keywords desde tu propio código
Crea consultas seguidas como un producto cruzado: tres keywords en dos motores y dos países son doce comprobaciones, creadas en una llamada. Elige comprobaciones diarias, semanales o mensuales, agrúpalas en clústeres, páusalas o reactívalas en bloque y calcula cuántas comprobaciones al mes consumirá una configuración antes de confirmarla. Cada escritura lleva un Idempotency-Key, así que un reintento nunca sigue dos veces la misma keyword.
Qué devuelve la API de seguimiento de posiciones
Las operaciones con las que empieza casi cualquier integración de seguimiento de
posiciones. Las rutas son relativas a un proyecto, /api/v1/organizations/{org}/projects/{project}, y la referencia completa documenta las 90.
| Operación | Qué obtienes |
|---|---|
GET /keyword-listings | Una fila por keyword con posición en Google, tasa de mención, cuota de voz y tendencias |
GET /tracked-queries/{id}/timeseries | Histórico diario, semanal o mensual de una keyword, también por competidor |
GET /timeseries | El mismo histórico para todo el proyecto |
GET /metrics/movers | Las keywords que más han ganado o perdido frente al periodo anterior |
GET /tracked-queries/{id}/serp-matches | Cada resultado orgánico en el que salió tu marca o un competidor, con su posición |
GET /search-snapshots | Las páginas de resultados de Google capturadas en cada comprobación |
GET /ai-responses | Las respuestas de IA capturadas completas, con las fuentes que citan |
GET /cited-sources | Los dominios y páginas que más citan las respuestas de IA en tu mercado |
POST /tracked-queries | Sigue keywords nuevas en varios motores y países con una sola llamada |
API rank tracker frente a API de SERP
| Aspecto | API de SERP | API rank tracker de Mencoro |
|---|---|---|
| Qué hace una llamada | Descarga una página de resultados en vivo | Lee comprobaciones que ya se hicieron según tu calendario |
| Posición de tu dominio | La sacas tú de los resultados | Ya asociada a ti y a tus competidores |
| Histórico y tendencias | Los guardas y calculas tú | 16 meses, por día, semana o mes |
| Respuestas de IA | En bruto, si el proveedor las extrae | Menciones, sentimiento y citas en ChatGPT, Perplexity, Claude, AI Overviews y el Modo IA |
| Qué pagas | Cada petición | Las comprobaciones que programas; leerlas va incluido |
¿Prefieres preguntar en lenguaje natural? El servidor MCP lleva los mismos datos a Claude, ChatGPT y Cursor, y en los mejores servidores MCP de SEO lo comparamos con las alternativas. Para verlo en un panel, mira el seguimiento de posiciones y cómo se calcula cada métrica.
FAQ
Preguntas sobre la API rank tracker
Dudas habituales sobre cómo sacar
los datos de posiciones por la API.
Empieza hoy a medir tu marca en los buscadores con IA
Controla cómo citan tu marca los motores de IA, sigue tus posiciones y compárate con la competencia, todo en una sola plataforma.