Saltar al contenido
CatálogoProductos

Contar productos

Devuelve cuántos productos coinciden con un filtro, sin devolverlos.

Parámetros de consulta

productIds?array<ResourceId>

Solo estos productos.

sourceIds?array<ResourceId>

Solo elementos importados desde estos orígenes.

channelIds?array<ResourceId>

Solo elementos de estos canales de venta.

modifierGroupIds?array<ResourceId>

Solo elementos que usan estas personalizaciones.

search?string

Búsqueda de texto libre.

searchNameAndSkuOnly?boolean

Busca solo en el nombre del producto, su SKU y los SKU de sus variantes, no en la descripción ni en los códigos de barras. El valor predeterminado es false.

status?array<>

Solo elementos en estos estados.

Valor en

  • "draft"
  • "active"
  • "inactive"
  • "outOfStock"
  • "discontinued"
  • "archived"
excludeStatus?array<>

Excluye los elementos en estos estados.

Valor en

  • "draft"
  • "active"
  • "inactive"
  • "outOfStock"
  • "discontinued"
  • "archived"
includeArchived?boolean

Incluye los elementos archivados.

categoryIds?array<ResourceId>

Solo elementos en estas categorías.

includeSubcategories?boolean

Incluye también los productos de las subcategorías de categoryIds, a cualquier profundidad. El valor predeterminado es false.

excludeCategoryIds?array<ResourceId>

Excluye los elementos en estas categorías.

brandIds?array<ResourceId>

Solo elementos de estas marcas.

excludeBrandIds?array<ResourceId>

Excluye los elementos de estas marcas.

storeIds?array<ResourceId>

Solo elementos de estas tiendas.

sellerIds?array<ResourceId>

Solo elementos de estos vendedores.

excludeSellerIds?array<ResourceId>

Excluye los elementos de estos vendedores.

skuIds?array<ResourceId>

Filtra por identificadores de variante.

skus?array<string>

Filtra por códigos SKU.

types?array<>

Solo estos tipos de producto.

Valor en

  • "product"
  • "service"
  • "bundle"
excludeTypes?array<>

Excluye estos tipos de producto.

Valor en

  • "product"
  • "service"
  • "bundle"
isFeatured?boolean

Solo elementos destacados.

ean?string

Filtra por código de barras EAN.

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
minDiscountPercent?number

Deja los productos cuyo precio está al menos este porcentaje por debajo de su precio de comparación, los dos de la variante activa más barata. Mayor que 0 y como máximo 100.

Formatodouble
minOnHand?integer

Existencias mínimas en almacén.

Formatoint32
maxOnHand?integer

Existencias máximas en almacén.

Formatoint32
minAvailable?integer

Existencias mínimas disponibles para vender.

Formatoint32
tags?array<string>

Solo elementos con alguna de estas etiquetas.

excludeTags?array<string>

Excluye los elementos con alguna de estas etiquetas.

limit?integer

Deja de contar al llegar a este número. Por defecto, 10000.

Formatoint32
exact?boolean

Cuenta todas las coincidencias e ignora limit. Más lento en catálogos grandes.

savedViewId?string

Parámetros de cabecera

x-Store-Id?string

Tienda sobre la que actúa la solicitud. No hace falta cuando el token ya está vinculado a una tienda.

Authorization*string

Token bearer OAuth 2.0.

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.ecomiq.pe/api/v1/catalog/products/count" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "total": 178,  "precision": "exact",  "limit": 25}