Guía de reviews

Las reviews pueden consultarse para sincronización, analítica, dashboards y reporting externo.

Endpoints

Método	Ruta	Uso
GET	/api/2026-04/reviews	Listar reviews para el contexto de la API key.
GET	/api/2026-04/reviews/{id}	Consultar una review por ID de Revi.
GET	/api/2026-04/products/{id_product}/reviews	Listar reviews de un producto.

Listar reviews

curl "https://api.revi.io/api/2026-04/reviews?from_date=2026-01-01&per_page=25&sort=date_desc" \
  -H "Accept: application/json" \
  -H "X-API-KEY: revi_test_xxxxxxxxx"

Filtros soportados:

Filtro	Descripción
page	Número de página, empezando en 1.
per_page	Tamaño de página, de 1 a 100. Por defecto es 25.
from_id	Reviews con ID mayor o igual al valor indicado.
to_id	Reviews con ID menor o igual al valor indicado.
from_date	Reviews desde esta fecha en adelante.
to_date	Reviews hasta esta fecha.
rating	Valoración exacta.
min_rating	Valoración mínima.
has_reply	true para reviews con respuesta del negocio, false para reviews sin respuesta.
type	shop o product.
id_product	ID externo de producto.
id_store	ID de tienda, o una lista de IDs numéricos separados por coma.
lang	Código de idioma.
sort	date_desc, date_asc, rating_desc o rating_asc.

Forma de una review

Las respuestas de listado y detalle pueden incluir:

Campo	Descripción
id	ID de review en Revi.
id_store	ID de tienda.
id_product	ID externo de producto en reviews de producto.
id_combination	ID externo de combinación de producto cuando esté disponible.
type	shop o product.
customer_name	Nombre público del autor; vacío en opiniones anónimas.
date	Fecha de la review.
comment	Texto de la review.
rating	Valoración.
lang	Idioma de la review.
anonymous	Indica si la review es anónima.
has_reply	Indica si la review tiene respuesta del negocio.

El endpoint específico de producto GET /api/2026-04/products/{id_product}/reviews devuelve una fila de review más pequeña para páginas de catálogo: id, customer_name, comment, rating, lang, anonymous y date.

Paginación

Las respuestas de listado incluyen metadatos de paginación:

{
  "meta": {
    "api_version": "2026-04",
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total": 100,
      "total_pages": 4
    }
  }
}

Privacidad

Los endpoints de reviews 2026-04 devuelven datos de representación: omiten correo, apellido, IP e identificadores de pedido. Es una restricción por privacidad del contrato existente. Las integraciones que usaban esos campos deben dejar de depender de ellos en estas llamadas.

Las integraciones entre servidores que necesiten datos personales utilizan 2026-10 con un cliente API Bearer, una tienda autorizada y reviews:read. El permiso adicional personal_data:read permite obtener correo, apellido y pedido disponibles en listado y detalle; las reviews de producto conservan una respuesta más pequeña, sin correo. Sin ese permiso, se omiten identidad del autor y pedido. Las opiniones anónimas nunca incluyen identidad ni identificadores de pedido, incluso con ese permiso.

Guarda las credenciales en tu servidor. Una respuesta de representación no autoriza a publicar una credencial privada en el navegador. Solicita y conserva solo los campos necesarios para tu integración.