Saltar al contenido
Consultas

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.

CampoTipoPredeterminadoReglas
includeFiltersBooleantrueCon 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.
searchString—Texto libre.
categories[String!]—Nombres de categoría.
brands[String!]—Nombres de marca.
sellerSlugs[String!]—Slugs de vendedor.
collections[String!]—Slugs de colección.
collectionIdString—ID de una colección.
productTypes[ProductType!]—PRODUCT, SERVICE o BUNDLE.
tags[String!]—Etiquetas.
filters[String!]—Hasta 100 facetas de hasta 250 caracteres.
inStockBoolean—Con true, solo productos disponibles.
minPriceDecimal—Precio mínimo.
maxPriceDecimal—Precio máximo.
pageInt1De 1 a 100.
pageSizeInt24De 1 a 100.
sortProductSearchSortDEFAULTOrden 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:valor

Elige un solo valor por opción de producto (por ejemplo, una talla). Los atributos admiten varios valores.

ProductSearchSort

ValorOrden
DEFAULTOrden predeterminado del catálogo.
PRICE_ASCMenor precio primero.
PRICE_DESCMayor precio primero.
NEWESTMás recientes primero.
NAME_ASCNombre de la A a la Z.
NAME_DESCNombre de la Z a la A.
OLDESTMás antiguos primero.
BEST_SELLINGMás vendidos primero; a igualdad, los más recientes.

SearchResult

CampoTipoDescripción
pageIndexInt!Página devuelta.
pageSizeInt!Tamaño de página aplicado.
totalCountLong!Total de coincidencias.
totalPagesInt!Total de páginas.
products[ProductSummary!]!Productos de la página.
filters[SearchFilter!]!Facetas para refinar la búsqueda.

ProductSummary

CampoTipoCampoTipo
idString!nameString!
slugString!urlString!
productTypeString!imageUrlString!
priceDecimal!compareAtPriceDecimal
variantCountInt!isAvailableBoolean!
totalInventoryInt!bundleItemsCountInt!
brandString!categoryString!
statusString!collections[String!]!
tags[String!]!sellerProductSellerInfo
options[ProductOptionGroup!]!images[ImageItem!]!
availableVariantIdStringreviews[StorefrontReviewDto!]!
  • url es la ruta pública del producto en la tienda.
  • seller tiene id, name y slug, todos String!.
  • options agrupa los valores de las variantes (key, name, type y values) para mostrar tallas y colores en la tarjeta sin pedir el detalle.
  • availableVariantId es la primera variante disponible, o null si no hay ninguna.
  • reviews trae las primeras reseñas aprobadas de cada producto. Consulta Reseñas de cada producto.

SearchFilter

CampoTipoDescripción
idString!ID del filtro.
labelString!Etiqueta para mostrar.
typeString!Tipo de filtro.
values[FacetItem!]!Valores y sus conteos.
minDecimalMínimo disponible, en filtros de rango.
maxDecimalMáximo disponible, en filtros de rango.
selectedMinDecimalMínimo elegido.
selectedMaxDecimalMáximo elegido.

FacetItem tiene value: String!, count: Int!, label: String y selected: Boolean!.

Ejemplo

Products.graphql
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"
  }
}
Terminal
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" }
    }
  }'
Respuesta
{
  "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!]!
ArgumentoPredeterminadoRegla
limit3De 1 a 10. Un valor fuera de rango se ajusta al extremo más cercano.
sortBycreatedOncreatedOn o rating, sin distinguir mayúsculas. Otro valor devuelve BAD_USER_INPUT.
sortDirectionSegún sortByASC 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.

ProductsWithReviews.graphql
query ProductsWithReviews($input: StorefrontProductsInput) {
  products(input: $input) {
    products {
      id
      name
      slug
      reviews(limit: 3, sortBy: "rating", sortDirection: DESC) {
        id
        rating
        title
        content
        reviewerName
        createdOn
      }
    }
  }
}
Respuesta
{
  "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ódigoCausa
BAD_USER_INPUTpage 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_FOUNDLa colección de collectionId no existe.
STORE_CONTEXT_REQUIREDx-Store-Domain falta o no corresponde a una tienda.

Equivalente REST

Productos REST acepta los mismos filtros por query string.

Última actualización:

En esta página