**版本：202601**

# 查询市场主题列表

**GET** `/openapi/2026-01/themes/merchant-themes`

返回主题市场中可安装的平台主题。支持按价格档、行业、语言、分类和特性过滤。

## 请求

**Query参数**

- `price` string

  按价格档过滤，逗号分隔；取值见 `MerchantTheme.price`
- `preset_default` string

  预置默认过滤：传 `1` 仅返回预置默认主题；不传则全部返回
- `industry` string

  按行业过滤，逗号分隔
- `language` string

  按语言过滤，逗号分隔
- `category` string

  按分类过滤，逗号分隔；取值见 `MerchantTheme.category`
- `features` string

  按特性过滤，逗号分隔
- `page` int32

  页码，从 1 开始；不传或传 0 时使用默认值 1
- `limit` int32

  每页条数，最大 200；不传或传 0 时使用默认值 200

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `merchant_themes` object[]

    可安装的市场主题列表

    *   Array \[

    - `id` string

      市场主题 id
    - `remote_theme_id` string

      远端主题 id（安装该主题时使用）
    - `name` string

      主题名称
    - `type` string

      主题类型：`shoplazza` 为内部主题，`developer` 为第三方开发者主题
    - `category` string

      主题分类
    - `desc` string

      主题描述（富文本 HTML）
    - `preset_name` string

      预设名称
    - `c_version` string

      当前版本号
    - `version_publish_time` string

      版本发布时间，格式 `YYYY-MM-DD HH:MM:SS`
    - `created_at` string

      创建时间，格式 `YYYY-MM-DD HH:MM:SS`
    - `default` string

      该主题是否为预置默认主题，用字符串布尔表示：`1` 是、`0` 否。与请求参数 `preset_default` 的过滤口径一致；与安装接口的 `default`（设为店铺默认主题）无关
    - `is_paid` boolean

      是否付费主题
    - `pc_cover_url` string

      PC 封面图 url
    - `mobile_cover_url` string

      移动端封面图 url
    - `preview_url` string

      预览 url
    - `change_log` string

      更新日志（JSON 字符串）
    - `exts` string

      扩展元数据（JSON 字符串：`tags`、`version_type` 等）
    - `preset_data` object

      主题的默认预设数据（即 `preset_name` 对应的配置值）
    - `presets` object

      该主题全部可选样式预设，按预设名键控 —— 安装该主题时 `preset` 参数的取值来源
    - `price` object

      价格档位

      - `values` GoogleProtobufValue[]
    *   \]
  - `total` int32

    主题总数
  - `total_pages` int32

    总页数
  - `current_page` int32

    当前页码
  - `limit` int32

    每页条数

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "merchant_themes": [
      {
        "id": "string",
        "remote_theme_id": "string",
        "name": "string",
        "type": "string",
        "category": "string",
        "desc": "string",
        "preset_name": "string",
        "c_version": "string",
        "version_publish_time": "string",
        "created_at": "string",
        "default": "string",
        "is_paid": true,
        "pc_cover_url": "string",
        "mobile_cover_url": "string",
        "preview_url": "string",
        "change_log": "string",
        "exts": "string",
        "preset_data": {},
        "presets": {},
        "price": {
          "values": [
            null
          ]
        }
      }
    ],
    "total": 0,
    "total_pages": 0,
    "current_page": 0,
    "limit": 0
  }
}
```