Xếp hạng sản phẩm - Bán chạy nhất

Giới thiệu

Lấy các sản phẩm bán chạy 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/topSelling

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
category_id	integer	Không	Danh mục sản phẩm
date_info	object	CÓ	Thông tin ngày, ví dụ {'type': 'day', 'value': '2026-02-01'}

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ả
units_sold	Không	Sản lượng bán (giảm dần)
gmv	Không	Doanh thu (giảm dần)
total_units_sold	Không	Tổng sản lượng bán (giảm dần)
total_gmv	Không	Tổng doanh thu (giảm dần)
growth_rate	Không	Tỷ lệ tăng trưởng (giảm dần)

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/product/v1/rank/topSelling' \
--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": "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ả
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
units_sold	integer	Sản lượng bán
gmv	integer	Doanh thu
total_units_sold	integer	Tổng sản lượng bán
total_gmv	integer	Tổng doanh thu
growth_rate	integer	Tỷ lệ tăng trưởng doanh số
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": "1729537665891078575",
        "title": "33.81oz Glass Water Cup, Large Glass Cup with Lid & Straw, Drinking Cup for Home Office Use, Drinkware Gift Ideas, Kitchen Accessories",
        "cover": "https://s.500fd.com/tt_product/16e26aec1fb94e3784665b5b2ecfe0e0~tplv-dx0w9n1ysr-resize-jpeg:800:800.jpeg",
        "real_price": "$10.94",
        "region": "US",
        "commission_rate": 1234,
        "category": {
          "l1": { "id": 123, "name": "test" }
        },

        "units_sold": 123,
        "gmv": 123,
        "total_units_sold": 123,
        "total_gmv": 123,
        "growth_rate": 123,

        "shop": {
          "seller_id": 123,
          "name": "test",
          "avatar": "xxx",
          "total_units_sold": 123
        }
      }
    ]
  }
}