Xếp hạng phát trực tiếp - Nhà sáng tạo phát trực tiếp hàng đầu

Giới thiệu

Lấy dữ liệu xếp hạng nhà sáng tạo theo doanh số phát trực tiếp TikTok, hỗ trợ các tính năng sau:

• Hỗ trợ tham số lọc
• Hỗ trợ sắp xếp kết quả tùy chỉnh

Endpoint API

    POST /live/v1/rank/topCreator

Phần thân yêu cầu

Trường	Kiểu	Bắt buộc	Mô tả
filter	object	Không	Tham số lọc
orderby	object	Không	Tham số sắp xếp
page	integer	Không	Mặc định: 1
pagesize	integer	Không	Mặc định: 10

page * pagesize <= 500

pagesize khoảng [1, 100]

Giá trị tùy chọn của filter

Trường	Kiểu	Bắt buộc	Mô tả
region	string	Không	Quốc gia/Khu vực
product_category_id	integer	Không	Danh mục sản phẩm (Cấp 1)
creator_category_id	integer	Không	Danh mục nhà sáng tạo
date_info	object	CÓ	Thông tin ngày: {"type":"day","value":"2025-02-01"}

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

Giá trị tùy chọn của orderby

Trường	Bắt buộc	Mô tả
units_sold	Không	Sản lượng bán (giảm dần)
gmv	Không	Doanh thu (giảm dần)

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/live/v1/rank/topCreator' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "region": "US",
        "product_category_id": 14,
        # "creator_category_id": 2,
        "date_info": {
            "type": "day",
            "value": "2026-04-01"
        }
        #,
        # "date_info": {
        #     "type": "week",
        #     "value": "2026-14"
        # },
        # "date_info": {
        #     "type": "month",
        #     "value": "2026-03"
        # }
    },
    "orderby": [
      {
        "field": "units_sold",
        "order": "desc"
      }
    ],
    "page": 1,
    "pagesize": 10
}'

Phần thân phản hồi

data.total

Tổng số kết quả

data.list

Trường	Kiểu	Mô tả
creator	object	Thông tin nhà sáng tạo
top_live	array[object]	Phát trực tiếp hàng đầu theo doanh số
sale_product_count	integer	Sản phẩm đang bán
live_units_sold	integer	Tổng sản lượng bán của phát trực tiếp
live_gmv	integer	Tổng doanh thu phát trực tiếp
live_usd_gmv	integer	Tổng doanh thu phát trực tiếp tính bằng USD
currency	string	Tiền tệ
live_count	integer	Số lượt phát trực tiếp

data.list:creator

Trường	Kiểu	Mô tả
uid	string	ID nhà sáng tạo
unique_id	string	ID duy nhất của nhà sáng tạo
nickname	string	Biệt danh nhà sáng tạo
avatar	string	URL ảnh đại diện nhà sáng tạo
region	string	Quốc gia/Khu vực
category	object	Danh mục nhà sáng tạo
follower_count	integer	Số người theo dõi của nhà sáng tạo

data.list:top_live

Trường	Kiểu	Mô tả
room_id	string	ID phòng phát trực tiếp
uid	string	ID nhà sáng tạo
region	string	Quốc gia/Khu vực
title	string	Tiêu đề phát trực tiếp
cover	string	Ảnh bìa phát trực tiếp
units_sold	integer	Sản lượng bán của phát trực tiếp
gmv	integer	Doanh thu của phát trực tiếp
currency	string	Tiền tệ

Ví dụ phản hồi

{
  "code": 0,
  "data": {
    "list": [
      {
        "creator": {
          "uid": 7291972001835992106,
          "unique_id": "highlanddaily1",
          "nickname": "highlanddaily1",
          "avatar": "https://s.500fd.com/tt_author/05cf95d47762fb424adeb44051ec003a~c5_300x300.jpeg",
          "region": "US",
          "category": {
            "id": 4,
            "name": "Beauty"
          },
          "follower_count": 77777777
        },
        "sale_product_count": 178,
        "live_units_sold": 57140,
        "live_gmv": 958762.84,
        "live_usd_gmv": 958762.84,
        "currency": "USD",
        "live_count": 6,
        "top_live": [
          {
            "room_id": "7621968386985085727",
            "uid": "7291972001835992106",
            "title": "Spring Glow Up LIVE",
            "region": "US",
            "cover": "https://s.500fd.com/tt_live/7584354100402735927~tplv-obj.image",
            "uints_sold": 72,
            "gmv": 1646.34,
            "currency": "USD"
          },
          {
            "room_id": "7621609989198727966",
            "uid": "7291972001835992106",
            "title": "Spring Glow Up LIVE",
            "region": "US",
            "cover": "https://s.500fd.com/tt_live/7584354100402735927~tplv-obj.image",
            "uints_sold": 20,
            "gmv": 292.64,
            "currency": "USD"
          }
        ]
      }
    ],
    "total": 500,
    "date_type": "week",
    "date_value": "2026-13"
  },
  "message": "",
  "timestamp": 1777297264,
  "request_id": "eeb9aec8-5bd6-2019-da8d-ba53c6946833"
}