Skip to main content

products

Searches the product catalog and returns a paginated list of products. Results can be filtered by product id, national code or EAN. When no filter is provided, all available products are returned page by page.

How to use this endpoint:

  • In order to retrieve information about the products, the HTTP header "locale" must be added to the request with the value "de_DE".
info

The maximum number of rows per page is 60.

products(
  productIds: [String!]
  productNationalCodes: [NationalCodeInput!]
  productEans: [String!]
  searchByCursor: Boolean
  nextCursor: String
  updatedAtFrom: String
  scope: ProductScope = ALL
): PaginatedProducts

Arguments​

products.productIds ● [String!] list scalar​

Product ids to fetch (UUIDs).

products.productNationalCodes ● [NationalCodeInput!] list input​

Filters products by their national codes.

Example (json):

[
  { "code": "45409790", "country": "DE" }
]

products.productEans ● [String!] list scalar​

Filters products by their EANs.

products.searchByCursor ● Boolean scalar​

Enables cursor-based pagination. Set to true on the first request to start paginating by cursor. When omitted, cursor pagination is disabled.

products.nextCursor ● String scalar​

The cursor pointing to the next page of results. Leave empty on the first request and, for subsequent requests, pass the nextCursor value returned in the previous response's metadata.

products.updatedAtFrom ● String scalar​

Filters products modified on or after the given date (ISO 8601, e.g. "2026-07-28").

products.scope ● ProductScope enum​

Restricts the result to a subset of the catalog. Defaults to ALL.

With SELLER_OFFERS, only the products for which the calling seller has an offer are returned, including offers with no stock or not active. The seller is always the one authenticated by the request token.

SELLER_OFFERS requires an authenticated request. Without a token the query returns the error SELLER_OFFERS_SCOPE_REQUIRES_SELLER; with an invalid or expired token it returns INVALID_TOKEN.

Type​

PaginatedProducts object​

A paginated collection of products.