Xếp hạng phát trực tiếp - Sản phẩm thịnh hành hàng đầu

Giới thiệu

Lấy dữ liệu cho xếp hạng sản phẩm thịnh hành của phát trực tiếp TikTok

• 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/topProduct

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
category_id	integer	Không	Danh mục sản phẩm (Cấp 1)
date_info	object	CÓ	Thông tin ngày: hằng ngày, hằng tuần, hằng tháng

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)
live_count	Không	Số phiên phát trực tiếp (giảm dần)

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/live/v1/rank/topProduct' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "region": "US",
        "category_id": 14,
        # "date_info": {
        #     "type": "day",
        #     "value": "2026-04-01"
        # },
        "date_info": {
            "type": "week",
            "value": "2026-13"
        }
        # ,
        # "date_info": {
        #     "type": "month",
        #     "value": "2026-04"
        # }
    },
     "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ả
product	object	Thông tin sản phẩm
shop	object	Thông tin cửa hàng
top_live	array[object]	Phát trực tiếp doanh số cao nhất
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
usd_gmv	integer	Doanh thu phát trực tiếp (USD)
currency	string	Tiền tệ
live_count	integer	Số phiên phát trực tiếp

data.list:product

Trường	Kiểu	Mô tả
product_id	string	ID sản phẩm
title	string	Tiêu đề sản phẩm
cover	string	URL ảnh bìa sản phẩm
real_price	string	Giá sản phẩm
currency	string	Tiền tệ
region	string	Quốc gia/Khu vực
category	object	Danh mục sản phẩm

data.list:product:category

Trường	Kiểu	Mô tả
l1	object	Danh mục cấp 1
l2	object	Danh mục cấp 2
l3	object	Danh mục cấp 3

data.list:shop

Trường	Kiểu	Mô tả
seller_id	string	ID cửa hàng
name	string	Tên cửa hàng
region	string	Quốc gia/Khu vực
avatar	string	URL logo cửa hàng

data.list:top_live

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

Ví dụ phản hồi

{
  "code": 0,
  "data": {
    "list": [
      {
        "product": {
          "product_id": "1729707172352594230",
          "title": "BASED Leave-in Conditioner | Instant Hydration & Anti-Frizz | Simple, Effective, BASED.",
          "cover": "https://s.500fd.com/tt_product/413c08135c3f48e480af5dd9aa5f60c2~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg",
          "region": "US",
          "currency": "USD",
          "real_price": "$17.00",
          "category": {
            "l1": {
              "id": 14,
              "name": "Beauty & Personal Care"
            },
            "l2": {
              "id": 848904,
              "name": "Haircare & Styling"
            },
            "l3": {
              "id": 601469,
              "name": "Shampoo & Conditioner"
            }
          }
        },
        "shop": {
          "seller_id": "7495079418085345590",
          "name": "BASED",
          "avatar": "https://s.500fd.com/tt_shop/c4e48f5ff0b242968e1d6212f3ab93f0~tplv-omjb5zjo8w-resize-png:300:300.png",
          "region": "US"
        },
        "rank_category": {
          "category_id": "14",
          "name": "Beauty & Personal Care"
        },
        "top_live": [
          {
            "room_id": "7619504259826060063",
            "title": "Spring Glow Up LIVE",
            "region": "US",
            "cover": "https://s.500fd.com/tt_live/55014e26dbf474c4a27a302cea499131~tplv-tiktokx-cropcenter:720:720.jpeg",
            "gmv": 14075,
            "units_sold": 563,
            "currency": "USD"
          },
          {
            "room_id": "7619504259826060063",
            "title": "Spring Glow Up LIVE",
            "region": "US",
            "cover": "https://s.500fd.com/tt_live/55014e26dbf474c4a27a302cea499131~tplv-tiktokx-cropcenter:720:720.jpeg",
            "gmv": 13850,
            "units_sold": 554,
            "currency": "USD"
          }
        ],
        "live_units_sold": 2985,
        "live_gmv": 74625,
        "live_usd_gmv": 74625,
        "live_count": 17
      }
    ],
    "total": 500,
    "date_type": "week",
    "date_value": "2026-13"
  },
  "message": "",
  "timestamp": 1777355755,
  "request_id": "7582c9e8-dc04-101a-5d39-cdd032716713"
}