**版本：202601**

# 查询市场商品

**GET** `/openapi/2026-01/markets/:id/products`

查询某个市场下的商品，本接口返回每个商品在该市场是否在售，及其按该市场货币计的价格。

## 请求

**Path参数**

- `id` string (required)

  市场 ID

**Query参数**

- `is_excluded` boolean

  按排除状态筛选：true 仅看排除商品，false 仅看包含商品，不传返回全部
- `keyword` string

  按商品标题搜索的关键词
- `collection_id` string

  按指定专辑筛选商品
- `sort_by` string

  排序字段
- `sort_direction` string

  排序方向（如 asc 或 desc）
- `cursor` string

  分页游标
- `page_size` int32

  每页返回的记录数，范围 1-100，默认 10

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `total_count` int64

    商品总数
  - `included_count` int64

    包含（在售）的商品数
  - `excluded_count` int64

    排除的商品数
  - `currency` string

    市场货币（ISO 4217）
  - `symbol` object

    市场货币符号信息

    - `val` string

      符号字符（如 £）
    - `left` string

      置于金额左侧的符号
    - `right` string

      置于金额右侧的符号
    - `cn_name` string

      货币中文名
    - `title` string

      货币名称
    - `code` string

      货币代码（ISO 4217）
  - `products` object[]

    商品列表

    *   Array \[

    - `id` string

      商品 ID
    - `title` string

      商品标题
    - `price_min` string

      最低价，字符串，按市场货币计价
    - `price_max` string

      最高价，字符串，按市场货币计价
    - `image` object

      商品图片

      - `src` string

        图片源地址
      - `alt` string

        替代文本
      - `width` int32

        图片宽度（像素）
      - `height` int32

        图片高度（像素）
      - `path` string

        图片路径
    - `is_excluded` boolean

      该商品是否已从市场排除
    - `total_fixed_price` int32

      该商品在此市场已设固定价的款式数量
    - `total_variants` int32

      商品的款式总数
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否还有更多记录

```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
  }
}
```