Saltar al contenido
Consultas

brand

Una marca activa por su slug, con sus productos en la misma consulta.

brand devuelve una marca activa a partir del slug de su URL. Su campo products trae los productos de la marca, con filtros y facetas, en la misma consulta.

brand(slug: String!): BrandDetail!

Argumentos

ArgumentoTipoRegla
slugString!Hasta 200 caracteres. Se recortan los espacios.

BrandDetail

CampoTipoDescripción
idString!ID de la marca.
nameString!Nombre.
slugString!Slug.
urlString!Ruta pública de la marca.
imageUrlStringLogo de la marca, o su ícono si no tiene logo.
descriptionStringDescripción.
metaTitleStringTítulo para buscadores.
metaDescriptionStringDescripción para buscadores.
productCountInt!Productos publicados con la marca.
products(input: StorefrontProductsInput)SearchResult!Productos de la marca.

products acepta el mismo input que products y devuelve el mismo SearchResult. Filtra por el nombre de la marca: reemplaza lo que envíes en brands.

Ejemplo

BrandPage.graphql
query BrandPage($slug: String!, $page: Int = 1) {
  brand(slug: $slug) {
    id
    name
    url
    imageUrl
    description
    products(input: { page: $page, pageSize: 24, includeFilters: false }) {
      totalPages
      products { id name url imageUrl price }
    }
  }
}
Terminal
curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: mi-tienda" \
  --data-binary '{
    "query": "query BrandPage($slug: String!, $page: Int = 1) { brand(slug: $slug) { id name url imageUrl description products(input: { page: $page, pageSize: 24, includeFilters: false }) { totalPages products { id name url imageUrl price } } } }",
    "variables": { "slug": "andina", "page": 1 }
  }'
Respuesta
{
  "data": {
    "brand": {
      "id": "7204558912004324355",
      "name": "Andina",
      "url": "/brands/andina",
      "imageUrl": "https://…/andina.webp",
      "description": "Prendas de algodón pima.",
      "products": {
        "totalPages": 1,
        "products": [
          {
            "id": "7204558912004322039",
            "name": "Polo de algodón pima",
            "url": "/products/polo-de-algodon-pima",
            "imageUrl": "https://…/polo.webp",
            "price": 59.9
          }
        ]
      }
    }
  }
}

Errores

CódigoCausa
BAD_USER_INPUTslug vacío o de más de 200 caracteres, o un input no válido.
NOT_FOUNDLa marca no existe en la tienda o está inactiva.
STORE_CONTEXT_REQUIREDx-Store-Domain falta o no corresponde a una tienda.

Equivalente REST

GET /v1/brands/{slug} devuelve la misma marca, sin products. Para sus productos, filtra GET /v1/products con su nombre en brands.

Última actualización:

En esta página