List products

get

https://api.duda.co/api/sites/multiscreen/{site_name}/ecommerce/products

Get products page. Default page response size is 50, max requested page size is 200.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

site_name

string

required

The site's unique name (its ID), returned when the site is created.

Query Params

offset

integer

≥ 0

Defaults to 0

Zero-based offset for elements (0..N)

limit

integer

1 to 200

Defaults to 50

The size of the page to be returned

sort

string

direction

string

enum

Defaults to asc

Order direction for property specified in sort

Allowed:

string

length ≥ 1

Match products whose name contains the given string, ignore-case, or whose own or variation sku equals it

category_id

array of strings

Return products assigned to any of the given category ids. Given exactly one category and no explicit sort, products keep their order within that category - unless option_id or several customization_id values are also given

category_id

status

array of objects

Return products in any of the given statuses

status

Allowed:

type

array of objects

Return products of any of the given types

type

Allowed:

array of strings

Return the products with any of the given ids

option_id

array of strings

Return products whose variations use any of the given option ids

option_id

customization_id

array of strings

Return products assigned any of the given customization ids

customization_id

product_url

string

length ≥ 1

Return the product whose seo.product_url equals the given slug

variation_external_id

string

length ≥ 1

Return the whole product that has a variation with the given external id - note this is the variation's external_id, not the product's own

created_at.gte

date-time

Return products whose created_at is at or after the given ISO-8601 timestamp. The offset is required - 2026-01-31T10:15:30Z or 2026-01-31T12:15:30+02:00

created_at.lte

date-time

Return products whose created_at is at or before the given ISO-8601 timestamp, offset required

updated_at.gte

date-time

Return products whose updated_at is at or after the given ISO-8601 timestamp, offset required. The entry point for incremental sync - unlike created_at it also catches edits of products fetched earlier

updated_at.lte

date-time

Return products whose updated_at is at or before the given ISO-8601 timestamp, offset required

on_sale

boolean

Return products whose compare_at_price is set (true) or unset (false). Variations carry a price difference rather than their own compare_at_price, so this always refers to the product-level price

has_variations

boolean

Return products that have (true) or do not have (false) variations

Responses

401

Unauthorized request - missing or invalid credentials

429

Rate limit exceeded - please refer to api documentation for limits

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Non-OK response from the server