**Version: 202607**

# 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` string (required)

  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 | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `total_count` int64

    Total number of products
  - `included_count` int64

    Number of included (selling) products
  - `excluded_count` int64

    Number of excluded products
  - `currency` string

    Market currency (ISO 4217)
  - `symbol` object

    Market currency symbol detail

    - `val` string

      Symbol value (e.g., £)
    - `left` string

      Symbol placed to the left of the amount
    - `right` string

      Symbol placed to the right of the amount
    - `cn_name` string

      Chinese name of the currency
    - `title` string

      Currency title
    - `code` string

      Currency code (ISO 4217)
  - `products` object[]

    Products

    *   Array \[

    - `id` string

      Product ID
    - `title` string

      Product title
    - `price_min` string

      Minimum price as a string, priced in the market currency
    - `price_max` string

      Maximum price as a string, priced in the market currency
    - `image` object

      Product image

      - `src` string

        Image source URL
      - `alt` string

        Alt text
      - `width` int32

        Image width in pixels
      - `height` int32

        Image height in pixels
      - `path` string

        Image path
    - `is_excluded` boolean

      Whether this product is excluded from the market
    - `total_fixed_price` int32

      Number of variants that have a fixed price set in this market
    - `total_variants` int32

      Total number of variants of the product
    *   \]
  - `cursor` string

    Cursor for pagination
  - `has_more` boolean

    Whether there are more records

```json
{
  "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
  }
}
```