Skip to content

达人带货商品

简介

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

接口信息

bash
POST /creator/v1/productList

request body

字段类型必选描述
filterobject过滤参数
pageinteger页码,默认值:1
pagesizeinteger每页条数,默认值:10

filter可选值

字段类型必选描述
uidstring达人uid
daysstring时间范围,例如:[0, 7, 14, 28, 90]

request example

bash
curl 'https://openapi.fastmoss.com/creator/v1/productList?client_id=XXX&timestamp=XXX&access_token=XXX&sign=XXX' \
--header 'Content-Type: application/json' \
{
    "filter": {
        "uid": "6893103660525831169",
        "days": 7
    },
    "page": 1,
    "pagesize": 10
}

response body

data.total

结果总条数

data.list

字段类型描述
product_idstring商品ID
uidstring达人 UID
seller_idstring商家ID
commission_rateinteger佣金比例
product_ratingstring商品评分
shop_titlestring店铺名称
shop_avatarstring店铺头像 URL
shop_units_countinteger店铺销量
shop_gmvfloat店铺GMV
titlestring商品标题
coverstring商品封面图 URL
categoryarray[object]商品分类
real_pricestring商品价格
regionstring商品地区
gmvfloat商品GMV
units_soldinteger商品销量
l1_category_idinteger商品一级分类ID
l2_category_idinteger商品二级分类ID
l3_category_idinteger商品三级分类ID

response example

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