Saltar al contenido
Consultas

productReviews

Reseñas aprobadas de un producto, paginadas por cursor, con búsqueda, filtro por calificación y orden.

productReviews devuelve las reseñas aprobadas de un producto, por páginas. Para la página siguiente, reenvía el nextCursor que recibiste.

productReviews(
  productId: String!
  limit: Int
  cursor: String
  search: String
  sortBy: String
  sortDirection: SortDirection
  rating: Int
): CursorPaginatedItemsOfStorefrontReviewDto!

Argumentos

ArgumentoPredeterminadoRegla
productId—El id del producto.
limit20De 1 a 200.
cursornullEl nextCursor de la página anterior. Hasta 2000 caracteres.
searchnullBusca en título, contenido y nombre de quien reseña. Hasta 200 caracteres.
sortBycreatedOncreatedOn o rating, sin distinguir mayúsculas.
sortDirectionSegún sortByASC o DESC. Sin valor, createdOn ordena DESC y rating, ASC.
ratingnullSolo reseñas con esa calificación exacta, de 1 a 5.

Si cambias search, rating o el orden, vuelve a empezar con cursor: null.

Retorno

CampoTipoDescripción
data[StorefrontReviewDto!]!Reseñas de la página.
hasNextPageBoolean!true si hay otra página.
nextCursorStringCursor para la página siguiente; null en la última.
totalCountLongReseñas que cumplen los filtros.

Cada reseña tiene id: String!, productId: String!, isVerifiedPurchase: Boolean!, rating: Int!, title: String, content: String!, reviewerName: String y createdOn: DateTime!.

Si el producto no existe, la respuesta trae data: [] y hasNextPage: false.

Ejemplo

ProductReviews.graphql
query ProductReviews($productId: String!, $cursor: String, $rating: Int) {
  productReviews(productId: $productId, limit: 20, cursor: $cursor, rating: $rating) {
    data {
      id
      isVerifiedPurchase
      rating
      title
      content
      reviewerName
      createdOn
    }
    hasNextPage
    nextCursor
    totalCount
  }
}
Terminal
curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: mi-tienda" \
  --data-binary '{
    "query": "query ProductReviews($productId: String!, $cursor: String, $rating: Int) { productReviews(productId: $productId, limit: 20, cursor: $cursor, rating: $rating) { data { id isVerifiedPurchase rating title content reviewerName createdOn } hasNextPage nextCursor totalCount } }",
    "variables": { "productId": "456", "cursor": null, "rating": 5 }
  }'
Respuesta
{
  "data": {
    "productReviews": {
      "data": [
        {
          "id": "7204558912004325999",
          "isVerifiedPurchase": true,
          "rating": 5,
          "title": "Excelente",
          "content": "Llegó rápido y bien empacada.",
          "reviewerName": "Ana",
          "createdOn": "2026-08-25T15:30:00Z"
        }
      ],
      "hasNextPage": true,
      "nextCursor": "eyJpZCI6IjcyMDQ1NTg5MTIwMDQzMjU5OTkifQ==",
      "totalCount": 31
    }
  }
}

La receta completa de «Cargar más» está en Paginar reseñas.

Errores

CódigoCausa
BAD_USER_INPUTproductId inválido, limit fuera de 1–200, rating fuera de 1–5, cursor o search demasiado largos, o sortBy distinto de createdOn y rating.
STORE_CONTEXT_REQUIREDx-Store-Domain falta o no corresponde a una tienda.

Equivalente REST

Listar reseñas de producto devuelve las mismas páginas. Para publicar una reseña, usa crear reseña.

Última actualización:

En esta página