List products

Products

Description

Search publicly available products.
Returns 30 products per page by default.

Parameters

page integer query

Page number for pagination

search string query required

Search query matched against the product name and description in the requested locale, as well as the brand. Also supports exact EAN/UPC matching.

merchant_id integer query

Filter search results to products with offers from a specific merchant.

Accept-Language string header

Locale for translated fields (name, description, categories). Defaults to English if omitted or if the requested locale has no translation. Supported values are en, fr, and es.

Responses

200 Successful response

application/json

statusstring

Example: success

dataarray

current_pageinteger

Example: 1

total_resultsinteger

Example: 150

total_pagesinteger

Example: 5

400 Search query is required

application/json

Example:

{
  "status": "error",
  "message": "Search query is required"
}

404 Page not found

application/json

Example:

{
  "status": "error",
  "message": "Page not found"
}