Agency Rank - Sales Rank

Introduction

Get TikTok partner agency sales rank data, supporting the following features:

• Set filter parameters
• Customize result sorting

Endpoint

    POST /agency/v1/rank/salesRank

Response Body

Field	Type	Required	Description
filter	object	No	Filter parameters
orderby	object	No	Sorting parameters
page	integer	No	Page number, default value: 1
pagesize	integer	No	Records per page, default: 10

filter options

Field	Type	Required	Description
region	string	No	Region
date_info	object	No	Date information

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

orderby options

Field	Required	Description
usd_gmv	No	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"
        }
    },
    "orderby": [
      {
        "field": "usd_gmv",
        "order": "desc",
      }
    ],
    "page": 1,
    "pagesize": 10
}'

Response Body

data.total

Total results

data.list

Field	Type	Description
id	string	Agency ID
secid	string	Agency secid
region	integer	Region
currency	integer	Currency
gmv	integer	GMV
usd_gmv	integer	USD GMV
gmv_inc_rate	string	GMV Growth Rate
commission_rate	integer	Commission Rate
hot_category	array<object>	Hot Categories
total_affiliate_count	integer	Total affiliated creators
inc_affiliate_count	integer	New affiliated creators
sale_affiliate_count	integer	Active sales creators
product_count	integer	Total products
inc_product_count	integer	New products
sale_product_count	integer	Active sales products
agency	object	Agency information

data.list.agency

Field	Type	Description
id	string	Agency ID
secid	string	Agency secid
name	string	Agency Name
region	string	Agency Region
introduction	string	Agency Introduction
logo_cover	string	Agency 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"
}