Peringkat Agensi - Peringkat Penjualan

Pendahuluan

Dapatkan data peringkat penjualan agensi mitra TikTok, mendukung fitur berikut:

• Atur parameter filter
• Sesuaikan pengurutan hasil

Endpoint

    POST /agency/v1/rank/salesRank

Isi Respons

Bidang	Tipe	Wajib	Deskripsi
filter	object	Tidak	Parameter filter
orderby	object	Tidak	Parameter pengurutan
page	integer	Tidak	Nomor halaman, nilai default: 1
pagesize	integer	Tidak	Catatan per halaman, default: 10

opsi filter

Bidang	Tipe	Wajib	Deskripsi
region	string	Tidak	Wilayah
date_info	object	Tidak	Informasi tanggal

rentang region: ['US','GB','MX','ES','DE','IT','FR','PT','NL','BE','AT','PL','ID','VN','MY','TH','PH','BR','JP','SG']

opsi orderby

Bidang	Wajib	Deskripsi
usd_gmv	Tidak	GMV (menurun)

Contoh Permintaan

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
}'

Isi Respons

data.total

Total hasil

data.list

Bidang	Tipe	Deskripsi
id	string	ID Agensi
secid	string	secid agensi
region	integer	Wilayah
currency	integer	Mata Uang
gmv	integer	GMV
usd_gmv	integer	GMV USD
gmv_inc_rate	string	Tingkat Pertumbuhan GMV
commission_rate	integer	Tingkat Komisi
hot_category	array<object>	Kategori Populer
total_affiliate_count	integer	Total kreator terafiliasi
inc_affiliate_count	integer	Kreator terafiliasi baru
sale_affiliate_count	integer	Kreator penjualan aktif
product_count	integer	Total produk
inc_product_count	integer	Produk baru
sale_product_count	integer	Produk penjualan aktif
agency	object	Informasi agensi

data.list.agency

Bidang	Tipe	Deskripsi
id	string	ID Agensi
secid	string	secid agensi
name	string	Nama Agensi
region	string	Wilayah Agensi
introduction	string	Pengantar Agensi
logo_cover	string	Logo Agensi

Contoh Respons

{
  "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"
}