getProductsCount

Obtén el recuento de todos los productos con filtros opcionales.

Descripción

Cuenta los productos que cumplen las condiciones de filtro de body. Se resuelve en un IProductsCount con totalAll, totalInCategory y totalInCategoryWithNested.

.getProductsCount( );

Esquema de parámetros

Esquema

body: any[]
Objetos de filtro con condiciones de búsqueda. Predeterminado: [].
ejemplo:

[
  {
    "attributeMarker": "price",
    "conditionMarker": "in",
    "statusMarker": "status_1",
    "conditionValue": {},
    "pageUrls": [
      "23-laminat-floorwood-maxima"
    ],
    "title": "Iphone 17 Pro"
  }
]

Ejemplos

Ejemplo mínimo

  const response = await Products.getProductsCount();

Ejemplo con filtros

const response = await Products.getProductsCount([
  { attributeMarker: 'price', conditionMarker: 'mth', conditionValue: 100 },
]);

Usa filtros para obtener el recuento de productos concretos:

attributeMarker: El identificador de texto del atributo indexado por el cual se filtran los valores. conditionMarker: El tipo de condición que se aplica al valor del atributo.

Marker	Significado	Ejemplo
eq	Igual	color = "red"
neq	No igual	category ≠ "archived"
in	Contiene (coincidencia de subcadena sin distinguir mayúsculas de minúsculas)	brand contiene "app"
nin	No contiene (coincidencia de subcadena sin distinguir mayúsculas de minúsculas)	brand no contiene "fake"
mth	Mayor que	price > 100
lth	Menos que	price < 50
exs	Existe (tiene valor)	Tiene descripción
nexs	No existe	Sin imagen
pat	Coincide con un patrón de expresión regular en el que cada * equivale exactamente a un carácter y _ a un espacio. Con la indexación de búsqueda activada, el patrón debe coincidir con el valor completo	currency coincide con "s" (encuentra "usd")
same	Tiene el mismo valor que al menos otro producto. conditionValue se ignora	productos que comparten precio
same_part	Tiene el mismo valor que otro producto tras cortar los últimos segmentos. conditionValue es delimiter|count (predeterminado -|2); un valor con count segmentos o menos se compara completo	los SKU "ABC-1-S" y "ABC-1-M" comparten "ABC"

conditionValue: El valor con el que comparar.

Ejemplo de respuesta

{
  "totalAll": 6,
  "totalInCategory": 0,
  "totalInCategoryWithNested": 0
}

Esquema de respuesta

Esquema: IProductsCount

totalAll: number
Número de productos visibles coincidentes en todo el catálogo, en cualquier página.
ejemplo: 100

totalInCategory: number
Número de productos coincidentes en la propia página de catálogo. Siempre 0 en getProductsCount, que no tiene página.
ejemplo: 50

totalInCategoryWithNested: number
Número de productos coincidentes en la página de catálogo y sus categorías anidadas. Siempre 0 en getProductsCount, que no tiene página.
ejemplo: 10

---

Ejemplos de uso

Guía paso a paso en la documentación:

• Get products count: obtén el número total de productos, con filtros opcionales.

Pruébalo en vivo

Ejecuta este método en el sandbox del JS SDK. En tu primera visita, conecta la URL de tu proyecto y el App Token y luego abre:

• Get products count: obtén el número total de productos, con filtros opcionales.