v1Recursos/SEO/getObtener el resumen de posicionamiento de una ubicación
Obtener el resumen de posicionamiento de una ubicación
Devuelve las palabras clave seguidas, la tendencia de posición mensual, la cuadrícula de posicionamiento y las tarjetas de estadísticas de una ubicación. Indique keywordId para limitar la cuadrícula a una sola palabra clave, o month (YYYY-MM) para fijarla a un mes específico en lugar del último informe medido de cada palabra clave.
get
seo:read/api/v1/seo/keywordsParámetros de consulta
locationIdstringobligatorio
La ubicación a consultar.
clientIdstringopcional
El cliente de la ubicación.
keywordIdstringopcional
Restringe la cuadrícula a una palabra clave seguida. Omítalo para la cuadrícula agregada de mejor posición por celda entre todas las palabras clave activas.
monthstringopcional
Fija la cuadrícula y las estadísticas a este mes (YYYY-MM) en lugar del último informe medido de cada palabra clave.
Respuesta
dataobjectopcional
Puede haber campos internos adicionales que no forman parte del contrato estable — dependa únicamente de los campos documentados aquí.
keywordsarray of objectopcional
Palabras clave seguidas de esta ubicación, cada una con su posición actual y su tendencia mensual.
idstringopcional
Identificador único de la palabra clave seguida.
keywordstringopcional
El texto de la palabra clave.
avgRanknumberopcional
La última posición promedio medida de la palabra clave en toda la cuadrícula (cuanto más bajo, mejor; null si nunca se midió o no está posicionando).
monthlyarray of objectopcional
La posición promedio de esta palabra clave para cada mes en que tiene un informe.
monthstringopcional
ranknumberopcional
monthsarray of objectopcional
Todos los meses con al menos un informe medido, del más antiguo al más reciente, con la posición promedio media entre palabras clave para ese mes.
keystringopcional
Mes en formato YYYY-MM.
labelstringopcional
Etiqueta legible para el mes, p. ej. "Aug 2026".
avgRanknumberopcional
Posición promedio media entre las palabras clave seguidas para este mes, o null.
gridarray of objectopcional
La cuadrícula de posicionamiento: una entrada por punto rastreado, combinada entre las palabras clave/mes en alcance.
idstringopcional
rowintegeropcional
Índice de fila de la cuadrícula.
colintegeropcional
Índice de columna de la cuadrícula.
latnumberopcional
Latitud de este punto de la cuadrícula.
lngnumberopcional
Longitud de este punto de la cuadrícula.
ranknumberopcional
Posición encontrada en este punto (cuanto más bajo, mejor); null si no se midió, los valores superiores a 20 significan "20+".
excludedbooleanopcional
Si este punto está excluido de los cálculos de estadísticas de la ubicación.
waterbooleanopcional
Si este punto cae en agua (mar, lago, río ancho) y solo se cuenta si la ubicación ha optado por incluir puntos de agua.
statsobjectopcional
Estadísticas de posición agregadas en toda la cuadrícula activa.
top3Pctnumberopcional
Porcentaje de puntos de la cuadrícula que posicionan en el top 3, o null.
top10Pctnumberopcional
Porcentaje de puntos de la cuadrícula que posicionan en el top 10, o null.
avgRanknumberopcional
Posición promedio en toda la cuadrícula, o null.
statCardsobjectopcional
Tarjetas destacadas que resumen la mejor/peor palabra clave de la ubicación y el mayor movimiento mes a mes.
bestobjectopcional
La palabra clave con la mejor (más baja) posición promedio actual, o null si ninguna ha posicionado.
keywordstringopcional
avgRanknumberopcional
worstobjectopcional
La palabra clave con la peor posición promedio actual, o null.
keywordstringopcional
avgRanknumberopcional
gainerobjectopcional
La palabra clave cuya posición mejoró más desde su primer mes hasta el más reciente, o null.
keywordstringopcional
fromnumberopcional
tonumberopcional
dropperobjectopcional
La palabra clave cuya posición empeoró más desde su primer mes hasta el más reciente, o null.
keywordstringopcional
fromnumberopcional
tonumberopcional
notRankingCountnumberopcional
Puntos de la cuadrícula que se midieron correctamente pero posicionan fuera del top 20, o null.
noDataCountnumberopcional
Puntos de la cuadrícula que no se pudieron medir en absoluto (falló el rastreo), distinto de no posicionar, o null.
centerobjectopcional
El punto central del mapa para la cuadrícula de esta ubicación (su ubicación de negocio), o null si aún no está configurado.
latnumberopcional
lngnumberopcional
includeWaterPointsbooleanopcional
Si esta ubicación ha optado por contar los puntos de la cuadrícula que caen en agua.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/seo/keywords
Su clave de API
locationId *
clientId
keywordId
month
{
"data": {
"keywords": [
{
"id": "cm_kw_abc123",
"keyword": "dentist near me",
"avgRank": 4.2,
"monthly": [
{
"month": "2026-01",
"rank": 5.1
},
{
"month": "2026-02",
"rank": 4.2
}
]
}
],
"months": [
{
"key": "2026-01",
"label": "Jan 2026",
"avgRank": 5.1
},
{
"key": "2026-02",
"label": "Feb 2026",
"avgRank": 4.2
}
],
"grid": [
{
"id": "cm_pt_1",
"row": 0,
"col": 0,
"lat": 30.2682,
"lng": -97.7441,
"rank": 3,
"excluded": false,
"water": false
}
],
"stats": {
"top3Pct": 44,
"top10Pct": 78,
"avgRank": 4.2
},
"statCards": {
"best": {
"keyword": "dentist near me",
"avgRank": 4.2
},
"worst": {
"keyword": "emergency dentist austin",
"avgRank": 9.6
},
"gainer": {
"keyword": "dentist near me",
"from": 5.1,
"to": 4.2
},
"dropper": {
"keyword": "family dentist",
"from": 3.8,
"to": 5.2
},
"notRankingCount": 1,
"noDataCount": 0
},
"center": {
"lat": 30.2672,
"lng": -97.7431
},
"includeWaterPoints": false
}
}