Skip to main content
POST
List Products Post Endpoint

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

merchant_id
string
required

Query Parameters

locale
string | null

Body

application/json
locale_id
string | null
market
string | null
market_group_id
string | null
limit
integer
default:50
Required range: 1 <= x <= 100
cursor
string | null
sort_by
enum<string>
default:revenue_desc
Available options:
relevance,
created_at_asc,
created_at_desc,
sale_price_asc,
sale_price_desc,
title_asc,
title_desc,
clicks_asc,
clicks_desc,
views_asc,
views_desc,
sold_asc,
sold_desc,
revenue_asc,
revenue_desc,
ctr_asc,
ctr_desc,
str_asc,
str_desc,
inventory_asc,
inventory_desc
search
string | null
filters
Filters · object | null
include_metrics
boolean
default:false
shopper_facing_only
boolean
default:false

Response

Successful Response

products
ListedProduct · object[]
required
sort_options
SortOptionItem · object[]
required
stats
ProductListingStats · object
required
next_cursor
string | null
has_more
boolean
default:false