getProductsCountByPageUrl

Obtener el número de productos de una página del catálogo por URL de página.

Descripción

Cuenta los productos de la página del catálogo con la url indicada, opcionalmente filtrados por las condiciones de body, y se resuelve en un IProductsCount.

.getProductsCountByPageUrl( , );

Esquema de parámetros

Esquema

url(required): string
URL de la página.

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.getProductsCountByPageUrl('catalog');

Ejemplo con filtros

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

Usa filtros para encontrar productos específicos:

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.

Marcador	Significado	Ejemplo
eq	Igual	color = "red"
neq	No igual	category ≠ "archivado"
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	Menor 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": 6,
  "totalInCategoryWithNested": 6
}

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:

• Obtener el número de productos por página: obtén el número total de productos de una página concreta del catálogo, útil para la paginación.

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:

• Obtener el número de productos por página: obtén el número total de productos de una página concreta del catálogo, útil para la paginación.