Agency Rank - Sales Rank
Introduction
Get TikTok partner agency sales rank data, supporting the following features:
- Set filter parameters
- Customize result sorting
Endpoint
bash
POST /agency/v1/rank/salesRankResponse 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
bash
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
json
{
"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"
}