products
Busca productos publicados con filtros, facetas, orden y paginación.
products busca en el catálogo publicado de la tienda. Úsala para listados, resultados de búsqueda y páginas de colección o de vendedor.
products(input: StorefrontProductsInput): SearchResult!Sin input, devuelve la primera página de 24 productos en el orden predeterminado.
Input
Todos los campos son opcionales y se combinan.
| Campo | Tipo | Predeterminado | Reglas |
|---|---|---|---|
includeFilters | Boolean | true | Con false, filters llega vacío. Úsalo en vitrinas sin panel de filtros. |
productIds | [String!] | — | Hasta 100 IDs. |
slugs | [String!] | — | Hasta 100 slugs de hasta 255 caracteres. Devuelve los productos en el orden de la lista. |
search | String | — | Texto libre. |
categories | [String!] | — | Nombres de categoría. |
brands | [String!] | — | Nombres de marca. |
sellerSlugs | [String!] | — | Slugs de vendedor. |
collections | [String!] | — | Slugs de colección. |
collectionId | String | — | ID de una colección. |
productTypes | [ProductType!] | — | PRODUCT, SERVICE o BUNDLE. |
tags | [String!] | — | Etiquetas. |
filters | [String!] | — | Hasta 100 facetas de hasta 250 caracteres. |
inStock | Boolean | — | Con true, solo productos disponibles. |
minPrice | Decimal | — | Precio mínimo. |
maxPrice | Decimal | — | Precio máximo. |
page | Int | 1 | De 1 a 100. |
pageSize | Int | 24 | De 1 a 100. |
sort | ProductSearchSort | DEFAULT | Orden de los resultados. |
Cada valor de filters tiene una de estas formas, con el nombre y el valor que trae filters en la respuesta:
option:nombre:valor
attribute:nombre:valorElige un solo valor por opción de producto (por ejemplo, una talla). Los atributos admiten varios valores.
ProductSearchSort
| Valor | Orden |
|---|---|
DEFAULT | Orden predeterminado del catálogo. |
PRICE_ASC | Menor precio primero. |
PRICE_DESC | Mayor precio primero. |
NEWEST | Más recientes primero. |
NAME_ASC | Nombre de la A a la Z. |
NAME_DESC | Nombre de la Z a la A. |
OLDEST | Más antiguos primero. |
BEST_SELLING | Más vendidos primero; a igualdad, los más recientes. |
SearchResult
| Campo | Tipo | Descripción |
|---|---|---|
pageIndex | Int! | Página devuelta. |
pageSize | Int! | Tamaño de página aplicado. |
totalCount | Long! | Total de coincidencias. |
totalPages | Int! | Total de páginas. |
products | [ProductSummary!]! | Productos de la página. |
filters | [SearchFilter!]! | Facetas para refinar la búsqueda. |
ProductSummary
| Campo | Tipo | Campo | Tipo |
|---|---|---|---|
id | String! | name | String! |
slug | String! | url | String! |
productType | String! | imageUrl | String! |
price | Decimal! | compareAtPrice | Decimal |
variantCount | Int! | isAvailable | Boolean! |
totalInventory | Int! | bundleItemsCount | Int! |
brand | String! | category | String! |
status | String! | collections | [String!]! |
tags | [String!]! | seller | ProductSellerInfo |
options | [ProductOptionGroup!]! | images | [ImageItem!]! |
availableVariantId | String | reviews | [StorefrontReviewDto!]! |
urles la ruta pública del producto en la tienda.sellertieneid,nameyslug, todosString!.optionsagrupa los valores de las variantes (key,name,typeyvalues) para mostrar tallas y colores en la tarjeta sin pedir el detalle.availableVariantIdes la primera variante disponible, onullsi no hay ninguna.reviewstrae las primeras reseñas aprobadas de cada producto. Consulta Reseñas de cada producto.
SearchFilter
| Campo | Tipo | Descripción |
|---|---|---|
id | String! | ID del filtro. |
label | String! | Etiqueta para mostrar. |
type | String! | Tipo de filtro. |
values | [FacetItem!]! | Valores y sus conteos. |
min | Decimal | Mínimo disponible, en filtros de rango. |
max | Decimal | Máximo disponible, en filtros de rango. |
selectedMin | Decimal | Mínimo elegido. |
selectedMax | Decimal | Máximo elegido. |
FacetItem tiene value: String!, count: Int!, label: String y selected: Boolean!.
Ejemplo
query Products($input: StorefrontProductsInput) {
products(input: $input) {
pageIndex
pageSize
totalCount
totalPages
products {
id
name
slug
imageUrl
price
compareAtPrice
isAvailable
brand
seller { id name slug }
}
filters {
id
label
type
min
max
values { value count label selected }
}
}
}{
"input": {
"search": "taza",
"categories": ["Hogar"],
"inStock": true,
"pageSize": 24,
"sort": "PRICE_ASC"
}
}curl --request POST "https://storefront.ecomiq.pe/graphql" \
--header "Content-Type: application/json" \
--header "x-Store-Domain: mi-tienda" \
--data-binary '{
"query": "query Products($input: StorefrontProductsInput) { products(input: $input) { pageIndex pageSize totalCount totalPages products { id name slug imageUrl price compareAtPrice isAvailable brand seller { id name slug } } filters { id label type min max values { value count label selected } } } }",
"variables": {
"input": { "search": "taza", "categories": ["Hogar"], "inStock": true, "pageSize": 24, "sort": "PRICE_ASC" }
}
}'{
"data": {
"products": {
"pageIndex": 1,
"pageSize": 24,
"totalCount": 1,
"totalPages": 1,
"products": [
{
"id": "789",
"name": "Taza de cerámica",
"slug": "taza-de-ceramica",
"imageUrl": "/taza.jpg",
"price": 12,
"compareAtPrice": null,
"isAvailable": true,
"brand": "Acme",
"seller": null
}
],
"filters": []
}
}
}Reseñas de cada producto
reviews devuelve, para cada producto del resultado, la misma primera página que productReviews con los mismos limit, sortBy y sortDirection.
reviews(limit: Int, sortBy: String, sortDirection: SortDirection): [StorefrontReviewDto!]!| Argumento | Predeterminado | Regla |
|---|---|---|
limit | 3 | De 1 a 10. Un valor fuera de rango se ajusta al extremo más cercano. |
sortBy | createdOn | createdOn o rating, sin distinguir mayúsculas. Otro valor devuelve BAD_USER_INPUT. |
sortDirection | Según sortBy | ASC o DESC. Sin valor, createdOn usa DESC y rating, ASC. |
Un producto sin reseñas aprobadas devuelve []. Para cursor, búsqueda o filtro por calificación, usa productReviews.
query ProductsWithReviews($input: StorefrontProductsInput) {
products(input: $input) {
products {
id
name
slug
reviews(limit: 3, sortBy: "rating", sortDirection: DESC) {
id
rating
title
content
reviewerName
createdOn
}
}
}
}{
"data": {
"products": {
"products": [
{
"id": "456",
"name": "Taza",
"slug": "taza",
"reviews": [
{
"id": "7204558912004325999",
"rating": 5,
"title": "Excelente",
"content": "Llegó rápido y bien empacada.",
"reviewerName": "Ana",
"createdOn": "2026-08-25T15:30:00Z"
}
]
}
]
}
}
}Errores
| Código | Causa |
|---|---|
BAD_USER_INPUT | page o pageSize fuera de 1–100, un ID inválido, más de 100 IDs, slugs o filtros, un filtro mal formado, dos valores para la misma opción o un sortBy de reviews distinto de createdOn y rating. |
NOT_FOUND | La colección de collectionId no existe. |
STORE_CONTEXT_REQUIRED | x-Store-Domain falta o no corresponde a una tienda. |
Equivalente REST
Productos REST acepta los mismos filtros por query string.
Última actualización: