查询市场主题列表

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

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

merchant_themes object[]

可安装的市场主题列表

Array [

idstring

市场主题 id

remote_theme_idstring

远端主题 id（安装该主题时使用）

namestring

主题名称

typestring

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

categorystring

主题分类

descstring

主题描述（富文本 HTML）

preset_namestring

预设名称

c_versionstring

当前版本号

version_publish_timestring

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

created_atstring

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

defaultstring

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

is_paidboolean

是否付费主题

pc_cover_urlstring

PC 封面图 url

mobile_cover_urlstring

移动端封面图 url

preview_urlstring

预览 url

change_logstring

更新日志（JSON 字符串）

extsstring

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

preset_dataobject

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

presetsobject

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

price object

价格档位

valuesGoogleProtobufValue[]

]

totalint32

主题总数

total_pagesint32

总页数

current_pageint32

当前页码

limitint32

每页条数

示例

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