GEO-商品专辑-列表

接口信息

• 接口地址: {your-site-url}/api/skill/geo/collection-list
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET
• 说明: 分页获取商品专辑的 GEO 数据列表。

认证

请求头中需要携带 skill-access-token：

请求参数

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/geo/collection-list?pageNum=1&pageSize=10' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw ''

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 5,
                "shop_id": 359,
                "collection_id": 20002,
                "language_code": "en",
                "summary": "A collection of outdoor camping tents designed for different outdoor activities.",
                "collection_type": "Camping Tents",
                "category_path": ["Outdoor Equipment", "Camping Gear", "Shelters", "Camping Tents"],
                "key_features": ["Various tent sizes and capacities"],
                "product_types": ["Family Camping Tents", "Portable Camping Tents"],
                "comparison_dimensions": ["Size", "Capacity", "Material"],
                "search_terms": ["camping tents", "outdoor shelter"],
                "geo_score": "88.50",
                "source_content_hash": "6a8f3d9c2b1e4f7a9d8c5b6e3f2a1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a",
                "created_at": "2026-08-20 22:02:52",
                "updated_at": "2026-08-20 22:02:52"
            }
        ],
        "total": 4,
        "pageSize": 1,
        "totalPage": 4
    },
    "message": "success"
}

返回字段说明

列表中每个元素为一条商品专辑 GEO 数据，完整字段说明见 GEO-商品专辑-保存。

注意事项

1. collection_ids 支持数组与逗号分隔字符串两种传法
2. 一个商品专辑只允许存在一份 GEO 数据（按 collection_id 唯一）