Saltar al contenido
Guías
CatálogoProductos
catalog:read

Contar productos

Devuelve cuántos productos coinciden con un filtro, sin devolverlos. Requiere menos recursos que recorrer una lista paginada cuando solo necesitas el total.

GET/v1/catalog/products/count

Devuelve cuántos productos coinciden con un filtro, sin devolverlos. Requiere menos recursos que recorrer una lista paginada cuando solo necesitas el total.

Autorización

bearerAuth
AutorizaciónBearer <token>

Token de acceso OAuth 2.0 emitido por Ecomiq Auth.

Ubicación: header

Parámetros de consulta

productIds?array<ResourceId>

Solo estos productos.

sourceIds?array<ResourceId>

Solo elementos importados desde estos orígenes.

search?string

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

status?array<>

Solo elementos en estos estados.

excludeStatus?array<>

Excluye los elementos en estos estados.

includeArchived?boolean

Incluye los elementos archivados.

categoryIds?array<ResourceId>

Solo elementos en estas categorías.

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.

excludeTypes?array<>

Excluye estos tipos de producto.

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
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

Cantidad máxima de resultados por devolver.

Formatoint32
exact?boolean
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://example.com/v1/catalog/products/count" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "total": 1,  "precision": "exact",  "limit": 1}