Synup
Crear clave
v1Recursos/Reviews/getListar competidores rastreados

Listar competidores rastreados

Los competidores rastreados para una ubicación, o —con clientId sin locationId— el conjunto conjunto (roll-up) a nivel de cliente mostrado en todas sus ubicaciones.

get/api/v1/reviews/competitors
reviews:read
Parámetros de consulta
locationIdstringopcional
La ubicación a consultar. Omítalo para listar en su lugar el conjunto conjunto a nivel de cliente — pase clientId en ese caso.
clientIdstringopcional
El cliente de la ubicación. Obligatorio junto con locationId; por sí solo lista el conjunto conjunto a nivel de cliente.
Respuesta
dataobjectopcional
competitorsarray of objectopcional
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.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/reviews/competitors
Su clave de API
locationId
clientId
{
  "data": {
    "competitors": [
      {
        "id": "cm_comp_1",
        "kind": "competitor",
        "source": "manual",
        "name": "Smile Bright Dental",
        "placeId": "ChIJtXC2rwgF9YgRNh1YJHlA4vQ",
        "address": "45 Congress Ave, Austin, TX",
        "lastUpdated": "2026-02-01T06:00:00.000Z",
        "avgRating": 4.6,
        "reviewCount": 340
      }
    ]
  }
}

Guías que usan este recurso