机构数据 - 达人列表

简介

获取机构关联的 TikTok 达人列表，支持以下功能：

• 按机构 ID 过滤达人
• 自定义排序方式
• 包含达人销售数据及热卖商品

接口

    POST /agency/v1/creatorList

Request Body

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

filter 可选值

字段	类型	必选	描述
id	string	是	机构 secid

orderby 可选值

字段	类型	必选	描述
field	string	是	排序字段
order	string	是	排序方式：desc

支持的排序字段：

字段	描述
day7_units_sold	近 7 天销量
day28_units_sold	近 28 天销量
day90_units_sold	近 90 天销量
day7_gmv	近 7 天 GMV
day28_gmv	近 28 天 GMV
day90_gmv	近 90 天 GMV
follower_count	粉丝数

请求示例

curl 'https://openapi.fastmoss.com/agency/v1/creatorList' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "id": "647f81f2fccde42ac22be7fe7bee2c26"
    },
    "orderby": [
        {
            "field": "day7_gmv",
            "order": "desc"
        }
    ],
    "page": 1,
    "pagesize": 10
}'

Response Body

data

字段	类型	描述
list	array<object>	达人列表
total	integer	总数

data.list

字段	类型	描述
author	object	达人信息
day7_units_sold	integer	近 7 天销量
day28_units_sold	integer	近 28 天销量
day90_units_sold	integer	近 90 天销量
day7_gmv	integer	近 7 天 GMV（美分）
day28_gmv	integer	近 28 天 GMV（美分）
day90_gmv	integer	近 90 天 GMV（美分）
live_gpm	string	直播 GPM 范围
video_gpm	string	视频 GPM 范围
day7_top2_products	array<object>	近 7 天销量 Top 2 商品
day28_top2_products	array<object>	近 28 天销量 Top 2 商品
day90_top2_products	array<object>	近 90 天销量 Top 2 商品

data.list.author

字段	类型	描述
uid	string	达人 UID
unique_id	string	达人唯一 ID
nickname	string	达人昵称
avatar	string	头像 URL
category_id	integer	类目 ID
category_name	string	类目名称
follower_count	integer	粉丝数
aweme_count	integer	视频总数
favoriting_count	integer	获赞总数
region	string	地区

data.list.dayX_top2_products

字段	类型	描述
product_id	string	商品 ID
sold_count	integer	销量
rank	integer	销售排名（1 或 2）
cover	string	商品封面图 URL

返回示例

{
  "code": 0,
  "data": {
    "list": [
      {
        "author": {
          "uid": "7520310673173316621",
          "unique_id": "sophmademebuyit",
          "nickname": "Soph🦋",
          "avatar": "tt_author/e2a93268378892efa5477548c160e19e~tplv-tiktokx-cropcenter:100:100.jpeg",
          "category_id": 31,
          "category_name": "Other",
          "follower_count": 29468,
          "aweme_count": 2042,
          "favoriting_count": 530,
          "region": "US"
        },
        "day7_units_sold": 4955,
        "day28_units_sold": 19952,
        "day90_units_sold": 51672,
        "day7_gmv": 270119,
        "day28_gmv": 1134310,
        "day90_gmv": 2922456,
        "live_gpm": "$0.00 - $0.00",
        "video_gpm": "$39.82 - $44.95",
        "day7_top2_products": [
          {
            "product_id": "1732261201982428094",
            "sold_count": 635,
            "rank": 2,
            "cover": "https://s.500fd.com/tt_product/293d96fb07b2482a89c0191e02072278~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg"
          },
          {
            "product_id": "1731581852072907320",
            "sold_count": 1078,
            "rank": 1,
            "cover": "https://s.500fd.com/tt_product/c7338303f352404a8a89ce2fded825c4~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg"
          }
        ]
      }
    ],
    "total": 1382
  },
  "message": "success"
}