List market themes

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

Retrieve the installable platform themes in the theme market. Supports filtering by price band, industry, language, category, and features.

Request

Query Parameters

price string

Filter by price band, comma-separated; values come from MerchantTheme.price

preset_default string

Preset-default filter: 1 returns only preset-default themes. Omit to return all

industry string

Filter by industry, comma-separated

language string

Filter by language, comma-separated

category string

Filter by category, comma-separated; values come from MerchantTheme.category

features string

Filter by features, comma-separated

page int32

Page number, starts at 1. Omit or pass 0 to use the default (1)

limit int32

Page size, up to 200. Omit or pass 0 to use the default (200)

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

merchant_themes object[]

Installable market themes

Array [

idstring

Merchant-theme id

remote_theme_idstring

Remote theme id (used when installing the theme)

namestring

Theme display name

typestring

Theme type: shoplazza for internal themes, developer for third-party developer themes

categorystring

Theme category

descstring

Rich-text theme description (HTML)

preset_namestring

Preset name

c_versionstring

Current version

version_publish_timestring

Version publish time, YYYY-MM-DD HH:MM:SS

created_atstring

Creation time, YYYY-MM-DD HH:MM:SS

defaultstring

Whether this theme is a preset-default theme, as a string boolean: 1 yes, 0 no. Matches the preset_default request filter; unrelated to InstallMerchantThemeRequest.default

is_paidboolean

Whether the theme is paid

pc_cover_urlstring

PC cover image url

mobile_cover_urlstring

Mobile cover image url

preview_urlstring

Preview url

change_logstring

Change log (JSON string)

extsstring

Extra metadata (JSON string: tags, version_type, ...)

preset_dataobject

Default preset data of the theme (the settings values of preset_name)

presetsobject

All available style presets, keyed by preset name — the source of the preset parameter when installing this theme

price object

Price bands

valuesGoogleProtobufValue[]

Repeated field of dynamically typed values.

]

totalint32

Total number of themes

total_pagesint32

Total number of pages

current_pageint32

Current page number

limitint32

Page size

Example

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