查询商品专辑列表

GET 
/openapi/2026-07/collections

根据商品 ID、专辑名称、更新时间等筛选条件分页查询商品专辑列表。

请求

Query参数

cursor string

分页游标

page_size int32

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

ids string[]

指定要查询的专辑 ID 列表。 示例：?ids=1001&ids=1002

title string

按专辑名称模糊筛选

updated_at_min string

筛选最后更新时间不早于该时间点的专辑，例如：2018-10-01T16:15:47-04:00

updated_at_max string

筛选最后更新时间不晚于该时间点的专辑，例如：2018-10-01T16:15:47-04:00

product_id string

商品 UUID，用于筛选包含该商品的专辑

smart boolean

是否仅返回智能专辑：true 仅返回智能专辑，false 仅返回手动专辑，不传则不限

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

collections object[]

专辑列表

Array [

idstring

专辑 ID

titlestring

专辑名称

descriptionstring

专辑描述

handlestring

专辑 handle（URL 友好的唯一别名）

smartboolean

是否为智能专辑（满足条件的商品自动加入）

image object

专辑封面

srcstring

图片来源 URL

widthint32

图片宽度（像素）

heightint32

图片高度（像素）

altstring

图片替代文本

seo_titlestring

专辑的 SEO 标题

seo_keywordsstring[]

SEO 关键词列表

seo_descriptionstring

专辑的 SEO 描述

sort_orderstring

专辑内商品的排序规则（取值见创建专辑接口）

created_atstring

专辑创建时间（ISO-8601 格式）

updated_atstring

专辑最后更新时间（ISO-8601 格式）

match_rules object

智能集合匹配规则

disjunctiveboolean

条件是否为析取关系（OR）

rule_modules object[]

规则模块列表

Array [

disjunctiveboolean

条件是否为析取关系（OR）

rules object[]

此模块中的规则列表

Array [

columnstring

列

relationstring

关联关系

conditionstring

条件

]

]

tagsstring[]

集合标签列表

product_countint64

集合中的商品数量

]

cursorstring

分页游标

has_moreboolean

是否还有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "collections": [
      {
        "id": "string",
        "title": "string",
        "description": "string",
        "handle": "string",
        "smart": true,
        "image": {
          "src": "string",
          "width": 0,
          "height": 0,
          "alt": "string"
        },
        "seo_title": "string",
        "seo_keywords": [
          "string"
        ],
        "seo_description": "string",
        "sort_order": "string",
        "created_at": "string",
        "updated_at": "string",
        "match_rules": {
          "disjunctive": true,
          "rule_modules": [
            {
              "disjunctive": true,
              "rules": [
                {
                  "column": "string",
                  "relation": "string",
                  "condition": "string"
                }
              ]
            }
          ]
        },
        "tags": [
          "string"
        ],
        "product_count": 0
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}