List market products

GET 
/openapi/2026-07/markets/:id/products

List the products of a market, this returns each product's on-sale status in this market and its price in the market's currency.

Request

Path Parameters

id stringrequired

Market ID

Query Parameters

is_excluded boolean

Filter by exclusion status: true returns only excluded products, false returns only included products, omit to return all

keyword string

Search keyword matched against product title

collection_id string

Filter products belonging to a specific collection

sort_by string

Field to sort by

sort_direction string

Sort direction (e.g., asc or desc)

cursor string

Cursor for pagination

page_size int32

A limit on the number of objects to return. Range: 1-100 (default is 10)

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

total_countint64

Total number of products

included_countint64

Number of included (selling) products

excluded_countint64

Number of excluded products

currencystring

Market currency (ISO 4217)

symbol object

Market currency symbol detail

valstring

Symbol value (e.g., £)

leftstring

Symbol placed to the left of the amount

rightstring

Symbol placed to the right of the amount

cn_namestring

Chinese name of the currency

titlestring

Currency title

codestring

Currency code (ISO 4217)

products object[]

Products

Array [

idstring

Product ID

titlestring

Product title

price_minstring

Minimum price as a string, priced in the market currency

price_maxstring

Maximum price as a string, priced in the market currency

image object

Product image

srcstring

Image source URL

altstring

Alt text

widthint32

Image width in pixels

heightint32

Image height in pixels

pathstring

Image path

is_excludedboolean

Whether this product is excluded from the market

total_fixed_priceint32

Number of variants that have a fixed price set in this market

total_variantsint32

Total number of variants of the product

]

cursorstring

Cursor for pagination

has_moreboolean

Whether there are more records

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "total_count": 0,
    "included_count": 0,
    "excluded_count": 0,
    "currency": "string",
    "symbol": {
      "val": "string",
      "left": "string",
      "right": "string",
      "cn_name": "string",
      "title": "string",
      "code": "string"
    },
    "products": [
      {
        "id": "string",
        "title": "string",
        "price_min": "string",
        "price_max": "string",
        "image": {
          "src": "string",
          "alt": "string",
          "width": 0,
          "height": 0,
          "path": "string"
        },
        "is_excluded": true,
        "total_fixed_price": 0,
        "total_variants": 0
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}