带货达人

简介

通过店铺的 seller_id 获取带货达人信息：

接口信息

POST /shop/v1/creatorList

request body

字段	类型	必选	描述
filter	object	否	过滤参数
orderby	array	否	排序参数
page	integer	否	默认:1
pagesize	integer	否	默认:10

filter 可选值

字段	类型	必选	描述
seller_id	string	否	店铺 ID
creator_uid	string	否	店铺关联达人uid
creator_unique_id	string	否	店铺关联达人唯一ID @xxxxxxx
seller_name	string	否	店铺名称
region	string	否	店铺所在国家/地区

seller_name 和 region 必须同时传

orderby 可选值

字段	必选	描述
digg_count	否	点赞数
follower_count	否	粉丝数
units_sold	否	销量
gmv	否	销售额

request example

curl 'https://openapi.fastmoss.com/shop/v1/creatorList' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "seller_id": "7495500842223700917",
        # "creator_uid": "xxxxxxxxxxx",
        # "creator_unique_id": "xxxxxxx",
        # "seller_name": "xxxxxx",
        # "region": "US"
    },
    "orderby": [{
        "field": "units_sold",
        "order": "desc"
    }],
    # "orderby": [{
    #     "field": "gmv",
    #     "order": "desc"
    # }],
    # "orderby": [{
    #     "field": "follower_count",
    #     "order": "desc"
    # }],
    # "orderby": [{
    #     "field": "digg_count",
    #     "order": "desc"
    # }],
    "page": 1,
    "pagesize": 10
}'

response body

data.total

结果总条数

data.list

字段	类型	描述
uid	string	达人 UID
seller_id	string	店铺 ID
unique_id	string	达人唯一ID @xxxxxxx
nickname	string	达人昵称
avatar	string	达人头像 URL
units_sold	integer	达人销量
gmv	float	达人GMV
category_id	integer	达人分类ID
category_name	string	达人分类名称
follower_count	integer	达人粉丝数
aweme_count	integer	达人视频数
favoriting_count	integer	达人收藏数
region	string	达人地区

response example

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 8,
    "list": [
      {
        "uid": "6893103660525831169",
        "seller_id": "xxxxxxxxxxxx",
        "units_sold": 1354,
        "gmv": 22034.6,
        "unique_id": "twobakeboys",
        "nickname": "Twobakeboys",
        "avatar": "https://s.500fd.com/tt_author/935c7d720caecc448ed85fbcbac1218b~c5_300x300.jpeg",
        "category_id": 5, //creator's category_id
        "category_name": "Food & Beverage", //creator's category_name
        "category": [
          //废弃
          "Food & Beverage"
        ],
        "follower_count": 22572,
        "aweme_count": 510,
        "favoriting_count": 480,
        "region": "SG" //creator's region
      }
    ]
  }
}