Synup
Crear clave
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/api/v1/seo/competitors/trends
seo:read
Pará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
        ]
      }
    ]
  }
}

Guías que usan este recurso