GEO-商品-列表

接口信息

• 接口地址: {your-site-url}/api/skill/geo/product-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/product-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": 6,
                "shop_id": 359,
                "product_id": 10851,
                "language_code": "en",
                "summary": "A cotton shirt dress designed with a comfortable fit and versatile style for daily wear.",
                "semantic_content": "This product is a cotton shirt dress featuring a lightweight fabric, practical design, and comfortable wearing experience.",
                "product_type": "Shirt Dress",
                "category_path": ["Apparel", "Women's Clothing", "Dresses", "Shirt Dresses"],
                "key_features": ["Cotton fabric", "Shirt-style design", "Comfortable fit"],
                "benefits": ["Provides comfortable wearing experience", "Easy to match with different outfits"],
                "purchase_reasons": ["Made with cotton material", "Practical shirt dress style"],
                "differentiators": ["Combines shirt structure with dress styling"],
                "applications": ["Casual wear", "Daily fashion"],
                "use_cases": ["Wearing during daily activities", "Casual outings"],
                "solution_scenarios": [{"user_need": "Looking for comfortable everyday clothing", "solution": "The cotton shirt dress provides a lightweight and practical wearing option"}],
                "target_users": ["Women looking for casual dresses"],
                "product_attributes": {"material": "Cotton", "style": "Casual", "category": "Dress"},
                "specifications": {"material": "Cotton", "available_sizes": ["S", "M", "L"]},
                "compatibility": [],
                "limitations": [],
                "not_suitable_for": [],
                "commercial_info": {"purchase_type": "Retail"},
                "faq": [{"question": "What material is this dress made of?", "answer": "This dress is made of cotton material."}],
                "search_terms": ["cotton shirt dress", "women casual dress"],
                "geo_score": "85.50",
                "source_content_hash": "8f7a9d3e6c4b2a1f9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b3a2f1e0d9c8b7a",
                "created_at": "2026-08-20 21:55:29",
                "updated_at": "2026-08-20 21:55:29"
            }
        ],
        "total": 4,
        "pageSize": 1,
        "totalPage": 4
    },
    "message": "success"
}

返回字段说明

列表中每个元素为一条商品 GEO 数据，字段与「GEO-商品-详细」返回一致，完整字段说明见 GEO-商品-保存。

注意事项

1. product_ids 支持数组与逗号分隔字符串两种传法
2. 一个商品只允许存在一份 GEO 数据（按 product_id 唯一）
3. 商品 GEO 数据通过 GEO-商品-保存 创建/更新