Skip to main content

Query products with filters and pagination.

POST 
/products/query

Query products using filters, sorting, and pagination. This endpoint supports a maximum of 10,000 results.

Filter: The filter object must have exactly one key. It can be a property filter (e.g. id, search, brand, publicCategories, organization, deleted, status, productFamilies, media, attributes, dietaryRestrictions, colors, createdAt, touchedAt, hasContent, hasCorrections, publicPrice, gtin, ean, activeIngredient, atc) or a compound filter (and, or, not). See the ProductFilter schema for details. Region-specific codes (e.g. cnk, pzn, cip13) may also be supported.

Pagination Limit: This endpoint can only return up to 10,000 products. If your query matches more than 10,000 products:

  • The total field in the response will be capped at 10,000
  • The totalExceedsLimit field will be set to true
  • Use the /products/stream endpoint to retrieve all matching products

Request​

Responses​

Successful operation