商品销量列表

简介

获取指定商品的销量数据，支持以下功能：

• 支持按商品 ID 查询
• 返回每日销量、销售额等详细信息
• 包含商品概览信息，如总销量、总销售额、相关视频数等

接口

    POST /product/v1/goodSalesList

filter 可选值

字段	类型	必选	描述
product_id	string	是	商品 ID
date_type	integer	是	时间范围，例如：25表示最近 25 天 ,最大不超过 28 天

request example

curl 'https://openapi.test.fastmoss.com/product/v1/goodSalesList?client_id=XXX&timestamp=XXX&access_token=XXX&sign=XXX' \
--header 'Content-Type: application/json' \
{
    "filter": {
        "product_id": "1729421229342823356",
        "date_type": "25"
    }
}

response body

data.list

字段	类型	描述
dt	string	日期
inc_sold_count	string	当日销量
inc_sale_amount	string	当日销售额

data.overview

字段	类型	描述
sold_count	integer	总销量
sale_amount	integer	总销售额
live_count	string	直播数量
author_count	string	作者数量
aweme_count	string	视频数量
currency	string	货币单位
region	string	国家/地区
desc	string	时间范围描述

response example

{
  "code": 0,
  "data": {
    "list": [
      {
        "dt": "2025-03-08",
        "inc_sold_count": "20",
        "inc_sale_amount": "500.00"
      }
    ],
    "overview": {
      "sold_count": 525,
      "sale_amount": 13125,
      "live_count": "168",
      "author_count": "129",
      "aweme_count": "87",
      "currency": "$",
      "region": "US",
      "desc": "last -25 days"
    }
  },
  "message": "",
  "timestamp": 1743573478,
  "request_id": "2014e9b1-c0f5-3457-217e-50b4b574c761"
}