店铺产品分析接口

接口信息

• 接口名称: 店铺产品分析接口
• 请求方法: GET
• 接口地址: /open-api/v1/data
• 接口路径: /v3/api/open/store/product-analysis
• 接口描述:
  • 查询指定店铺的产品统计分析数据
  • 统计店铺在不同平台推广的产品数量、分类分布和价格区间分布
  • 支持按时间范围筛选产品数据
  • 帮助分析店铺的产品策略和定价策略
  • 价格说明: 免费

请求头:

• Content-Type: application/json
• Accept: application/json

请求参数

请求结构

请求体参数 (params 对象)

请求示例

curl -X POST "https://www.pipispy.com/open-api/v1/data" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "key": "your_api_key_here",
    "uri": "/v3/api/open/store/product-analysis",
    "params": {
      "id": "9407a696eb444",
      "start_time": 1761408000,
      "end_time": 1763999999
    }
  }'

响应参数

响应体结构

{
    "code": 200,
    "message": "success",
    "data": {
        "total": {
            "all": 0,
            "total": 25,
            "tiktok": 25,
            "facebook": 0
        },
        "price": {
            "100": 4,
            "10-20": 0,
            "50-100": 16,
            "1-10": 0,
            "20-50": 5
        },
        "type": [
            {
                "ai_type_name_zh": "女装",
                "count": 12,
                "ai_type_name_en": "Women's Clothing",
                "ai_type": "62739c0138365b2f72048ed7"
            },
            {
                "ai_type_name_zh": "其他",
                "count": 2,
                "ai_type_name_en": "Other",
                "ai_type": "62739c2138365b2f72048edb"
            },
            {
                "ai_type_name_zh": "男装",
                "count": 2,
                "ai_type_name_en": "Men's Clothing",
                "ai_type": "62739c0d38365b2f72048ed8"
            }
        ]
    },
    "version": "v1",
    "timestamp": null,
    "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
    "success": true,
    "fail": false
}

响应字段说明

响应结果信息字段

data 对象结构

total 对象结构（平台分布统计）

type 数组元素结构（产品分类）

price 对象结构（价格区间分布，单位：美元）

响应示例

完整数据示例

{
    "code": 200,
    "message": "success",
    "data": {
        "total": {
            "all": 0,
            "total": 25,
            "tiktok": 25,
            "facebook": 0
        },
        "price": {
            "100": 4,
            "10-20": 0,
            "50-100": 16,
            "1-10": 0,
            "20-50": 5
        },
        "type": [
            {
                "ai_type_name_zh": "女装",
                "count": 12,
                "ai_type_name_en": "Women's Clothing",
                "ai_type": "62739c0138365b2f72048ed7"
            },
            {
                "ai_type_name_zh": "其他",
                "count": 2,
                "ai_type_name_en": "Other",
                "ai_type": "62739c2138365b2f72048edb"
            },
            {
                "ai_type_name_zh": "男装",
                "count": 2,
                "ai_type_name_en": "Men's Clothing",
                "ai_type": "62739c0d38365b2f72048ed8"
            }
        ]
    },
    "version": "v1",
    "timestamp": null,
    "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
    "success": true,
    "fail": false
}

按时间范围筛选示例

请求参数：

{
  "id": "12345",
  "start_time": 1704067200,
  "end_time": 1706745599
}

响应数据（仅返回在指定时间范围内最新发现的产品）：

{
  "code": 200,
  "message": "success",
  "data": {
    "total": {
      "total": 125,
      "tiktok": 95,
      "facebook": 68,
      "all": 38
    },
    "type": [
      {
        "ai_type": "fashion",
        "ai_type_name_zh": "时尚服饰",
        "ai_type_name_en": "Fashion & Apparel",
        "count": 52
      },
      {
        "ai_type": "electronics",
        "ai_type_name_zh": "电子产品",
        "ai_type_name_en": "Electronics",
        "count": 38
      },
      {
        "ai_type": "beauty",
        "ai_type_name_zh": "美妆护肤",
        "ai_type_name_en": "Beauty & Personal Care",
        "count": 35
      }
    ],
    "price": {
      "100": 2,
      "1-10": 45,
      "10-20": 52,
      "20-50": 20,
      "50-100": 6
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "fail": false,
  "success": true
}

错误码说明

使用说明

1. 时间范围筛选

接口支持通过 start_time 和 end_time 参数筛选产品：

• 筛选维度：产品的最新发现时间（all_latest_found_time）
• 不传时间参数：返回店铺所有产品的统计数据
• 只传 start_time：返回从该时间点到现在发现的产品
• 只传 end_time：返回从最早到该时间点发现的产品
• 都传：返回该时间范围内发现的产品

2. 平台分布统计说明

total 字段解读：

{
  "total": 850,      // 店铺总共推广了850个产品
  "tiktok": 620,     // 其中620个产品在TikTok平台有广告
  "facebook": 480,   // 其中480个产品在Facebook平台有广告
  "all": 250         // 其中250个产品同时在两个平台都有广告
}

关系说明：

• tiktok + facebook - all = 只在单一平台推广的产品数
• 只在 TikTok：tiktok - all = 370个
• 只在 Facebook：facebook - all = 230个
• 两平台都有：all = 250个
• 总计：370 + 230 + 250 = 850个

3. 产品分类统计说明

AI 智能分类：

• 系统使用 AI 算法自动识别产品类别
• 每个产品都有对应的分类代码和中英文名称
• 分类统计帮助了解店铺的产品结构

常见分类：

• fashion：时尚服饰
• electronics：电子产品
• home_garden：家居园艺
• beauty：美妆护肤
• sports：运动户外
• toys：玩具游戏
• food：食品饮料
• pet：宠物用品
• etc.

4. 价格区间分布说明

价格统计规则：

• 优先使用产品的美元价格（usd_price）
• 如果没有美元价格但货币为 USD，使用原价格（price）
• 其他货币暂不统计

价格区间划分：