Saltar al contenido
docs
Guías
EN
Contenido y tiendaProductos

Buscar productos

Devuelve una página del catálogo publicado junto con las facetas aplicables, de modo que un panel de filtros no necesita una segunda solicitud. Todos los filtros son opcionales y se combinan entre sí.

GET/v1/products

Devuelve una página del catálogo publicado junto con las facetas aplicables, de modo que un panel de filtros no necesita una segunda solicitud. Todos los filtros son opcionales y se combinan entre sí.

Parámetros de consulta

productIds?array<ResourceId>

Solo estos productos.

search?string

Filtro de texto libre. Los campos consultados dependen del recurso.

categories?array<string>
brands?array<string>
sellers?array<string>
collections?array<string>
collectionId?string

Identificador de la colección.

productTypes?array<>
tags?array<string>

Solo elementos con alguna de estas etiquetas.

filters?array<string>
inStock?boolean
minPrice?number

Precio mínimo a incluir, en la moneda de la tienda.

Formatodouble
maxPrice?number

Precio máximo a incluir, en la moneda de la tienda.

Formatodouble
page*integer

Número de página, empezando en uno.

Formatoint32
pageSize*integer
Formatoint32
sort?string

Parámetros de cabecera

x-Store-Domain*string

Slug o dominio configurado que selecciona el contexto de tienda en el gateway central de Storefront.

Longitud1 <= length <= 253

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/products?page=1&pageSize=1" \  -H "x-Store-Domain: my-store"
{  "pageIndex": 1,  "pageSize": 1,  "totalCount": 1,  "totalPages": 1,  "products": [    {      "id": "7204558912004325301",      "name": "Example resource",      "slug": "example-resource",      "productType": "example",      "imageUrl": "https://example.com/resource",      "price": 1,      "compareAtPrice": 1,      "variantCount": 1,      "isAvailable": false,      "totalInventory": 1,      "bundleItemsCount": 1,      "brand": "example",      "category": "example",      "status": "example",      "collections": [        "example"      ],      "tags": [        "example"      ],      "seller": {        "id": "7204558912004325301",        "name": "Example resource",        "slug": "example-resource"      }    }  ],  "filters": [    {      "id": "7204558912004325301",      "label": "example",      "type": "example",      "values": [        {          "value": "example",          "count": 1,          "label": "example",          "selected": false        }      ],      "min": 1,      "max": 1,      "selectedMin": 1,      "selectedMax": 1    }  ]}