GEO-商品-详细

接口信息

• 接口地址: {your-site-url}/api/skill/geo/product-info
• 基础 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-info?product_id=10851' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw ''

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "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"
    },
    "message": "success"
}

返回字段说明

返回字段即商品 GEO 数据字段，完整字段说明见 GEO-商品-保存。

注意事项

1. product_id 为必填，缺失时接口返回错误
2. 返回中的 JSON 语义字段（category_path、key_features、faq 等）为已解析后的数组/对象

3. 该商品的 GEO 数据不存在时返回 data 为 null

4. product_id 缺失时返回错误码 100701003（product id empty | product_id can not empty）