Xếp hạng nhà sáng tạo - Nhà sáng tạo TMĐT hàng đầu

Giới thiệu

Lấy xếp hạng các nhà sáng tạo TMĐT hàng đầu

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

Endpoint API

    POST /creator/v1/rank/topEcommerce

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	Số trang, mặc định: 1
pagesize	integer	Không	Số mục mỗi trang, mặc định: 10

page * pagesize <= 1000

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
creator_category_id	integer	Không	Danh mục nhà sáng tạo
product_category_id	integer	Không	Danh mục sản phẩm
account_type	integer	Không	Loại nhà sáng tạo 1:cá nhân 2:cửa hàng
ecommerce_type	integer	Không	1:Video 2:Trực tiếp
date_info	object	CÓ	Thông tin ngày

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ả
creator_usd_gmv	Không	Tổng GMV (USD) (giảm dần)
video_usd_gmv	Không	GMV video (USD) (giảm dần)
live_usd_gmv	Không	GMV phát trực tiếp (USD) (giảm dần)

Khi ecommerce_type trống, mặc định là giảm dần theo creator_usd_gmv. Khi ecommerce_type=1, mặc định là giảm dần theo video_usd_gmv. Khi ecommerce_type=2, mặc định là giảm dần theo live_usd_gmv. Trong các trường hợp khác, orderby không hợp lệ.

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/creator/v1/rank/topEcommerce' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "region": "US",
        "product_category": 1,
        "date_info": {
            "type": "day",
            "value": "2023-02-01"
        },
        # "date_info": {
        #     "type": "week",
        #     "value": "2023-18"
        # },
        # "date_info": {
        #     "type": "month",
        #     "value": "2023-02"
        # }
    },
     "orderby": [
      {
        "field": "total_gmv",
        "order": "desc",
      }
    ],
    "page": 1,
    "pagesize": 10
}'

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

data.total

• Kiểu: integer
• Mô tả: Tổng số kết quả

data.list

Trường	Kiểu	Mô tả
uid	string	ID nhà sáng tạo
follower_count	integer	Số người theo dõi của nhà sáng tạo
product_count	integer	Số sản phẩm đã bán
creator_gmv	float	Tổng GMV của nhà sáng tạo
creator_usd_gmv	float	Tổng GMV của nhà sáng tạo (USD)
video_count	integer	Số video
video_gmv	float	Tổng GMV của video
video_usd_gmv	float	Tổng GMV của video (USD)
live_count	integer	Số lượt phát trực tiếp
live_gmv	float	Tổng GMV phát trực tiếp
live_usd_gmv	float	Tổng GMV phát trực tiếp (USD)

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
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
video_count	integer	Số video

Ví dụ phản hồi

{
  "code": 0,
  "data": {
    "list": [
      {
        "creator": {
          "uid": "6795828506624754693",
          "nickname": "thebeautycrop",
          "unique_id": "thebeautycrop",
          "avatar": "https://s.500fd.com/tt_author/09c29664a10b2eeee9089b311a7cd8df~tplv-tiktokx-cropcenter:300:300.jpeg",
          "region": "GB",
          "category": {
            "id": 2,
            "name": "Shopping & Retail"
          },
          "follower_count": 238703,
          "video_count": 3123
        },
        "follower_count": 238703,
        "product_count": 96,
        "creator_gmv": 20310.4,
        "creator_usd_gmv": 25184.84,
        "video_count": 105,
        "video_gmv": 7632.68,
        "video_usd_gmv": 9464.46,
        "live_count": 11,
        "live_gmv": 12677.72,
        "live_usd_gmv": 15720.38,
        "uid": "6795828506624754693",
        "nickname": "thebeautycrop", //deprecated
        "unique_id": "thebeautycrop", //deprecated
        "avatar": "https://s.500fd.com/tt_author/09c29664a10b2eeee9089b311a7cd8df~tplv-tiktokx-cropcenter:300:300.jpeg", //deprecated
        "region": "GB", //deprecated
        "category": {
          "id": 2,
          "name": "Shopping & Retail"
        } //deprecated
      }
    ],
    "total": "256",
    "date_type": "week",
    "date_value": "2026-03"
  },
  "message": "",
  "timestamp": 1776165689,
  "request_id": "55dc7b93-227b-de9b-2a7e-6eb7f9259555"
}