Saltar al contenido
Contenido y tiendaProductos

Buscar productos

Devuelve una página del catálogo publicado con facetas; los filtros son opcionales y combinables.

GET/v1/products
Sin token

Parámetros de consulta

includeFilters?boolean
productIds?array<ResourceId>

Solo estos productos.

slugs?array<string>

Slugs de los productos que se devuelven, en este orden. Úsalo para productos elegidos a mano o vistos recientemente.

search?string

Búsqueda de texto libre.

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

Identificador de la colección.

categoryId?string

Identificador de la categoría.

productTypes?array<>

Valor en

  • "product"
  • "service"
  • "bundle"
tags?array<string>

Solo elementos con alguna de estas etiquetas.

filters?array<string>

Filtros como option:name:value o attribute:name:value, copiados de filters en la respuesta. Un valor por opción.

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

Valor en

  • "default"
  • "priceAsc"
  • "priceDesc"
  • "newest"
  • "nameAsc"
  • "nameDesc"
  • "oldest"
  • "bestSelling"

Parámetros de cabecera

x-Store-Domain*string

Slug de la tienda o uno de sus dominios configurados, como my-store.

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://storefront.ecomiq.pe/v1/products" \  -H "x-Store-Domain: my-store"
{  "pageIndex": 1,  "pageSize": 25,  "totalCount": 24,  "totalPages": 1,  "products": [    {      "id": "7204558912004322039",      "name": "Polo de algodón",      "slug": "polo-de-algodon",      "url": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",      "productType": "product",      "imageUrl": "https://mi-tienda.ecomiq.app/images/polo-de-algodon.webp",      "price": 89,      "compareAtPrice": 99,      "variantCount": 24,      "isAvailable": true,      "totalInventory": 24,      "bundleItemsCount": 24,      "brand": "Andina",      "category": "Polos",      "status": "active",      "collections": [        "Polo de algodón"      ],      "tags": [        "algodón"      ],      "seller": {        "id": "7204558912004322039",        "name": "Polo de algodón",        "slug": "polo-de-algodon"      },      "options": [        {          "key": "color",          "name": "Polo de algodón",          "type": "Polo de algodón",          "values": [            {              "key": "color",              "name": "Polo de algodón",              "value": "Mi tienda",              "valueId": "7204558912004324721",              "valueName": "Polo de algodón",              "type": "Mi tienda",              "color": "Azul",              "imageUrl": "https://mi-tienda.ecomiq.app/images/polo-de-algodon.webp",              "unit": "Mi tienda"            }          ]        }      ],      "images": [        {          "url": "https://mi-tienda.ecomiq.app/images/polo-de-algodon.webp",          "name": "polo-de-algodon.webp",          "order": 1,          "type": "image"        }      ],      "availableVariantId": "7204558912004322596"    }  ],  "filters": [    {      "id": "option:color",      "label": "Color",      "type": "option",      "values": [        {          "value": "Mi tienda",          "count": 24,          "label": "Mi tienda",          "selected": false        }      ],      "min": 1,      "max": 1,      "selectedMin": 1,      "selectedMax": 1    }  ]}