อันดับเอเจนซี - อันดับยอดขาย

บทนำ

รับข้อมูลอันดับยอดขายของเอเจนซีพาร์ตเนอร์ TikTok รองรับคุณสมบัติต่อไปนี้:

• ตั้งค่าพารามิเตอร์ตัวกรอง
• ปรับแต่งการจัดเรียงผลลัพธ์

เอนด์พอยต์

    POST /agency/v1/rank/salesRank

เนื้อความการตอบกลับ

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
filter	object	ไม่	พารามิเตอร์ตัวกรอง
orderby	object	ไม่	พารามิเตอร์การจัดเรียง
page	integer	ไม่	หมายเลขหน้า ค่าเริ่มต้น: 1
pagesize	integer	ไม่	จำนวนรายการต่อหน้า ค่าเริ่มต้น: 10

ตัวเลือก filter

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
region	string	ไม่	ภูมิภาค
date_info	object	ไม่	ข้อมูลวันที่

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

ตัวเลือก orderby

ฟิลด์	จำเป็น	คำอธิบาย
usd_gmv	ไม่	GMV (จากมากไปน้อย)

ตัวอย่างคำขอ

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

เนื้อความการตอบกลับ

data.total

ผลลัพธ์ทั้งหมด

data.list

ฟิลด์	ประเภท	คำอธิบาย
id	string	ID เอเจนซี
secid	string	secid ของเอเจนซี
region	integer	ภูมิภาค
currency	integer	สกุลเงิน
gmv	integer	GMV
usd_gmv	integer	GMV (USD)
gmv_inc_rate	string	อัตราการเติบโตของ GMV
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	โลโก้เอเจนซี

ตัวอย่างการตอบกลับ

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