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
| Argumento | Predeterminado | Regla |
|---|---|---|
productId | — | El id del producto. |
limit | 20 | De 1 a 200. |
cursor | null | El nextCursor de la página anterior. Hasta 2000 caracteres. |
search | null | Busca en título, contenido y nombre de quien reseña. Hasta 200 caracteres. |
sortBy | createdOn | createdOn o rating, sin distinguir mayúsculas. |
sortDirection | Según sortBy | ASC o DESC. Sin valor, createdOn ordena DESC y rating, ASC. |
rating | null | Solo 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
| Campo | Tipo | Descripción |
|---|---|---|
data | [StorefrontReviewDto!]! | Reseñas de la página. |
hasNextPage | Boolean! | true si hay otra página. |
nextCursor | String | Cursor para la página siguiente; null en la última. |
totalCount | Long | Reseñ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
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
}
}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 }
}'{
"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ódigo | Causa |
|---|---|
BAD_USER_INPUT | productId 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_REQUIRED | x-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: