Xếp hạng sản phẩm - Được quảng bá nhiều nhất

Giới thiệu

Lấy các sản phẩm được quảng bá nhiều nhất, với 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 /product/v1/rank/mostPromoted

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 <= 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
date_info	object	CÓ	Thông tin ngày, ví dụ {'type': 'day', 'value': '2026-02-01'}
category_id	integer	Không	Danh mục sản phẩm
is_cross_border	integer	Không	Sản phẩm có phải xuyên biên giới không
is_fully_managed	integer	Không	Sản phẩm có phải Fully Managed không

Khu vực khả dụng: ['US', 'ID', 'GB', 'VN', 'TH', 'MY', 'PH', 'SG', 'ES', 'MX', 'DE', 'FR', 'PT', 'NL', 'BE', 'AT', 'PL', 'IT', 'BR', 'JP']

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

Trường	Bắt buộc	Mô tả
affiliate_count	Không	Số liên kết (giảm dần)
total_affiliate_count	Không	Tổng số liên kết (giảm dần)

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/product/v1/rank/mostPromoted' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "region": "US",
        "category_id": 2,
        "date_info": {
            "type": "day",
            "value": "2026-02-01"
        },
        # "date_info": {
        #     "type": "week",
        #     "value": "2026-18"
        # },
        # "date_info": {
        #     "type": "month",
        #     "value": "2026-02"
        # }
    },
     "orderby": [
      {
        "field": "affiliate_count",
        "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ả
product_id	string	ID sản phẩm
title	string	Tiêu đề sản phẩm
region	string	Quốc gia/Khu vực
cover	string	URL ảnh bìa sản phẩm
category	object	Danh mục sản phẩm
commission_rate	integer	Tỷ lệ hoa hồng
real_price	string	Giá sản phẩm
currency	string	tiền tệ của giá
units_sold	integer	Sản lượng bán
gmv	integer	Doanh thu
affiliate_count	integer	Số liên kết
total_affiliate_count	integer	Tổng số liên kết
shop	object	Thông tin cửa hàng

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
avatar	string	URL ảnh bìa cửa hàng
total_units_sold	integer	Tổng sản lượng bán của cửa hàng

Ví dụ phản hồi

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 500,
    "list": [
      {
        "product_id": "1731252369156444451",
        "units_sold": 833,
        "gmv": 14994,
        "affiliate_count": 214,
        "total_affiliate_count": 8176,
        "off_shelves": 0,
        "launch_time": 1748956607,
        "title": "e.l.f. Halo Glow Skin Tint SPF 50 - Hydrating Serum-Like Concealer with Mineral SPF 50 Sunscreen, Lightweight & Water-Resistant, 18 Shades, 30ml",
        "cover": "https://s.500fd.com/tt_product/f9b6e759e360420384cdacec82808f85~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg",
        "region": "US",
        "currency": "USD",
        "real_price": "$18.00",
        "commission_rate": 1500,
        "category": {
          "l1": {
            "id": 14,
            "name": "Beauty & Personal Care"
          },
          "l2": {
            "id": 848648,
            "name": "Makeup"
          },
          "l3": {
            "id": 601554,
            "name": "Concealer & Foundation\t"
          }
        },
        "shop": {
          "avatar": "https://s.500fd.com/tt_shop/9ff01cdd6a0e4497aa55aae3403362c5~tplv-omjb5zjo8w-resize-png:300:300.png",
          "seller_id": "7494913857786775843",
          "name": "e.l.f. Cosmetics",
          "total_units_sold": 2369716,
          "is_fully_managed": null
        }
      }
    ]
  }
}