v1Recursos/SEO/getObtener la tendencia de posición de los competidores a lo largo del tiempo
Obtener la tendencia de posición de los competidores a lo largo del tiempo
Devuelve la posición promedio mensual de cada competidor a lo largo del historial de posicionamiento seguido de esta ubicación (hasta los últimos 12 meses medidos), para el gráfico de tendencia de posición. Incluye su propio negocio (isYou).
get
seo:read/api/v1/seo/competitors/trendsParámetros de consulta
locationIdstringobligatorio
La ubicación a consultar.
clientIdstringopcional
El cliente de la ubicación.
Respuesta
dataobjectopcional
monthsarray of stringopcional
Meses cubiertos, del más antiguo al más reciente (YYYY-MM).
competitorsarray of objectopcional
Una serie por competidor (además de su propio negocio), alineada con months.
placeIdstringopcional
Un identificador para este negocio (su ID de lugar, o una clave derivada).
namestringopcional
Nombre del negocio.
isYoubooleanopcional
Si esta serie es su propio negocio.
monthlyarray of numberopcional
Posición promedio para cada mes en months; null cuando este negocio no se observó ese mes.
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/competitors/trends
Su clave de API
locationId *
clientId
{
"data": {
"months": [
"2026-01",
"2026-02"
],
"competitors": [
{
"placeId": "ChIJtXC2rwgF9YgRNh1YJHlA4vQ",
"name": "Acme Dental — Downtown",
"isYou": true,
"monthly": [
5.1,
4.2
]
}
]
}
}