Skip to content

Product Sales List

Introduction

Get sales data for specified products with the following features:

  • Query by product ID
  • Returns daily sales and revenue details
  • Includes product overview information such as total sales, total revenue, and related video count

API

bash
    POST /product/v1/goodSalesList

filter Optional Values

FieldTypeRequiredDescription
product_idstringYesProduct ID
date_typeintegerYesTime range, e.g., 25 represents last 25 days, max 28 days

Request Example

bash
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

FieldTypeDescription
dtstringDate
inc_sold_countstringDaily sales
inc_sale_amountstringDaily revenue

data.overview

FieldTypeDescription
sold_countintegerTotal sales
sale_amountintegerTotal revenue
live_countstringLive stream count
author_countstringAuthor count
aweme_countstringVideo count
currencystringCurrency unit
regionstringCountry/Region
descstringTime range description

Response Example

json
{
  "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"
}