查询市场商品

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

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

请求

Path参数

id string必填

市场 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

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

total_countint64

商品总数

included_countint64

包含（在售）的商品数

excluded_countint64

排除的商品数

currencystring

市场货币（ISO 4217）

symbol object

市场货币符号信息

valstring

符号字符（如 £）

leftstring

置于金额左侧的符号

rightstring

置于金额右侧的符号

cn_namestring

货币中文名

titlestring

货币名称

codestring

货币代码（ISO 4217）

products object[]

商品列表

Array [

idstring

商品 ID

titlestring

商品标题

price_minstring

最低价，字符串，按市场货币计价

price_maxstring

最高价，字符串，按市场货币计价

image object

商品图片

srcstring

图片源地址

altstring

替代文本

widthint32

图片宽度（像素）

heightint32

图片高度（像素）

pathstring

图片路径

is_excludedboolean

该商品是否已从市场排除

total_fixed_priceint32

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

total_variantsint32

商品的款式总数

]

cursorstring

分页游标

has_moreboolean

是否还有更多记录

示例

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