Synup
Crear clave
v1Recursos/Reviews/getListar reseñas

Listar reseñas

Devuelve reseñas de una ubicación. Se requieren tanto locationId como clientId.

get/api/v1/reviews
reviews:read
Parámetros de consulta
locationIdstringobligatorio
La ubicación a consultar.
clientIdstringobligatorio
El cliente de la ubicación.
sitesstringopcional
Plataformas de reseñas a incluir, separadas por comas (p. ej. google,facebook).
ratingsstringopcional
Calificaciones en estrellas a incluir, separadas por comas (p. ej. 1,2).
sentimentstringopcional
Sentimientos a incluir, separados por comas (positive, neutral, negative).
statusstring (responded | unreplied)opcional
Filtrar por estado de respuesta: responded o unreplied.
keywordstringopcional
Búsqueda de texto libre en el cuerpo de la reseña y el autor.
fromstringopcional
Inicio de la ventana (fecha ISO).
tostringopcional
Fin de la ventana (fecha ISO).
sortstring (newest | oldest | lowest | highest)opcional
Orden: newest, oldest, lowest o highest.
deletedstring (1)opcional
Pase 1 para mostrar reseñas eliminadas/no presentes en lugar de las activas.
cursorstringopcional
Cursor de paginación del nextCursor de una respuesta anterior.
limitintegeropcional
Reseñas por página, 1-100. Por defecto 30.
Respuesta
dataobjectopcional
foundbooleanopcional
Si la ubicación se encontró y era accesible para esta clave.
reviewsarray of objectopcional
Las reseñas en sí.
idstringopcional
Identificador único de la reseña.
authorstringopcional
Nombre de quien escribió la reseña, o null si la fuente no lo proporcionó.
ratingnumberopcional
Calificación en estrellas, o null.
bodystringopcional
El texto de la reseña.
reviewDatestringopcional
Fecha de publicación de la reseña, como marca de tiempo ISO 8601, o null.
platformstringopcional
Plataforma de origen, p. ej. google, facebook.
platformLabelstringopcional
Nombre visible de la plataforma de origen, o null.
sentimentstringopcional
Sentimiento detectado de la reseña, o null.
replyobjectopcional
La respuesta del negocio, si la hay, o null.
authorstringopcional
bodystringopcional
datestringopcional
reviewUrlstringopcional
Enlace a la reseña en su plataforma de origen, o null.
respondablebooleanopcional
Si todavía se puede publicar una respuesta a esta reseña.
nextCursorstringopcional
Cursor de paginación para la siguiente página, o null cuando no hay más resultados.
totalnumberopcional
Número total de reseñas que coinciden con la solicitud.
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/reviews
Su clave de API
locationId *
clientId *
sites
ratings
sentiment
status
keyword
from
to
sort
deleted
cursor
limit
{
  "data": {
    "found": true,
    "reviews": [
      {
        "id": "rev_1",
        "author": "Jane D.",
        "rating": 5,
        "body": "Great service!",
        "reviewDate": "2026-02-01T12:00:00.000Z",
        "platform": "google",
        "platformLabel": "Google",
        "sentiment": "positive",
        "reply": null,
        "reviewUrl": "https://google.com/...",
        "respondable": true
      }
    ],
    "nextCursor": null,
    "total": 1
  }
}

Guías que usan este endpoint