达人带货商品

简介

通过达人的 uid 获取达人带货商品信息：

接口信息

POST /creator/v1/productList

request body

字段	类型	必选	描述
filter	object	是	过滤参数
orderby	object	否	排序参数
page	integer	否	页码，默认值：1
pagesize	integer	否	每页条数，默认值：10

filter可选值

字段	类型	必选	描述
uid	string	是	达人uid
days	string	否	时间范围，例如：[0, 7, 14, 28, 90]

orderby可选值

字段	必选	描述
units_sold	否	商品销量（降序）
gmv	否	商品 GMV（降序）
commission_rate_percent	否	佣金比例（降序）

orderby 格式：{"field": "units_sold", "order": "desc"}。不传时默认按 product_id 降序，保证分页结果稳定。

request example

curl 'https://openapi.fastmoss.com/creator/v1/productList' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "uid": "6893103660525831169",
        "days": 7
    },
    "orderby": {
        "field": "units_sold",
        "order": "desc"
    },
    # "orderby": {
    #     "field": "gmv",
    #     "order": "desc"
    # },
    # "orderby": {
    #     "field": "commission_rate_percent",
    #     "order": "desc"
    # },
    "page": 1,
    "pagesize": 10
}'

response body

data.total

结果总条数

data.list

字段	类型	描述
product_id	string	商品ID
uid	string	达人 UID
seller_id	string	商家ID
commission_rate	integer	佣金比例
product_rating	string	商品评分
shop_title	string	店铺名称
shop_avatar	string	店铺头像 URL
shop_units_count	integer	店铺销量
shop_gmv	float	店铺GMV
title	string	商品标题
cover	string	商品封面图 URL
category	array[object]	商品分类
real_price	string	商品价格
region	string	商品地区
gmv	float	商品GMV
units_sold	integer	商品销量
l1_category_id	integer	商品一级分类ID
l2_category_id	integer	商品二级分类ID
l3_category_id	integer	商品三级分类ID

response example

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 8,
    "list": [
      {
        "product_id": "1729539239170312086",
        "uid": "6893103660525831169",
        "seller_id": "7494962456968727446",
        "commission_rate": 0,
        "product_rating": "0.0",
        "shop_title": "Twobakeboys",
        "shop_avatar": "https://s.500fd.com/tt_shop/6413a6ce066e4108a30e50d1033dac88~tplv-aphluv4xwc-resize-png:300:300.png",
        "shop_units_count": 23867,
        "shop_gmv": 607576.80,
        "title": "Pineapple tart 230g per bottle",
        "cover": "https://s.500fd.com/default/product_default.png",
        "category": [
            "Food & Beverages"
        ],
        "real_price": "S$15.00",
        "region": "SG",//product's region
        "gmv": 0,
        "units_sold": 0,
        "l1_category_id":24,//product's l1 category_id
        "l2_category_id":915336,//product's l2 category_id
        "l3_category_id":700553//product's l3 category_id
      }
     ]
 }
}