机构榜单-销量榜

简介

获取TikTok合作机构销量榜单数据，支持以下功能：

• 支持设置过滤参数
• 支持自定义结果排序方式

接口

    POST /agency/v1/rank/salesRank

request body

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

filter可选值

字段	类型	必选	描述
region	string	否	国家/地区
date_info	object	否	日期信息

region 范围: ['US','GB','MX','ES','DE','IT','FR','ID','VN','MY','TH','PH','BR','JP','SG']

orderby可选值

字段	必选	描述
usd_gmv	否	销售额(desc)

request example

curl 'https://openapi.fastmoss.com/agency/v1/rank/salesRank' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "region": "US",
        "date_info": {
            "type": "week",
            "value": "2026-05"
        }
        #,
        # "date_info": {
        #     "type": "month",
        #     "value": "2026-03"
        # }
    },
    "orderby": [
      {
        "field": "usd_gmv",
        "order": "desc"
      }
    ],
    "page": 1,
    "pagesize": 10
}'

response body

data.total

结果总条数

data.list

字段	类型	描述
id	string	机构ID
secid	string	机构secid
region	integer	国家/地区
currency	integer	货币
gmv	integer	销售额
usd_gmv	integer	销售额(美元)
gmv_inc_rate	string	销售额增长率
commission_rate	integer	佣金比例
hot_category	array<object>	热门类目
total_affiliate_count	integer	总关联达人数
inc_affiliate_count	integer	新增关联达人数
sale_affiliate_count	integer	动销达人数
product_count	integer	总商品数
inc_product_count	integer	新增商品数
sale_product_count	integer	动销商品数
agency	object	机构信息

data.list.agency

字段	类型	描述
id	string	机构ID
secid	string	机构secid
name	string	机构名称
region	string	机构地区
introduction	string	机构介绍
logo_cover	string	机构logo

response example

{
  "code": 0,
  "data": {
    "list": [
      {
        "id": "8649512756612795142",
        "secid": "7c3d85e96c36244a5f5184a5cfbb98f6",
        "region": "GB",
        "currency": "GBP",
        "gmv": 209066.76,
        "usd_gmv": 259242.78,
        "gmv_inc_rate": "-24.91%",
        "commission_rate": 990,
        "hot_category": [
          { "category_id": 14, "name": "Beauty & Personal Care" },
          { "category_id": 2, "name": "Womenswear & Underwear" },
          { "category_id": 3, "name": "Menswear & Underwear" }
        ],
        "total_affiliate_count": 301,
        "inc_affiliate_count": 67,
        "sale_affiliate_count": 138,
        "product_count": 63610,
        "inc_product_count": 656,
        "sale_product_count": 22035,
        "agency": {
          "id": "8649512756612795142",
          "secid": "7c3d85e96c36244a5f5184a5cfbb98f6",
          "name": "VibraVerse",
          "region": "GB",
          "introduction": "",
          "logo_cover": "https://s.500fd.com/tt_partner/wsos65b11f86df324b05"
        }
      }
    ],
    "total": 500,
    "date_type": "week",
    "date_value": "2026-03"
  },
  "msg": "success"
}