Xếp hạng sản phẩm - Mới niêm yết

Giới thiệu

Lấy các sản phẩm mới niêm yế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/newListed

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 date_info: ['day'] (chỉ hỗ trợ day), value phải là ngày của 3 ngày trước, định dạng: YYYY-MM-DD

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

Trường	Bắt buộc	Mô tả
day3_units_sold	Không	Sản lượng bán 3 ngày
day3_gmv	Không	Doanh thu 3 ngày
total_units_sold	Không	Tổng sản lượng bán
total_gmv	Không	Tổng doanh thu

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/product/v1/rank/newListed' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "region": "US",
        "category_id": 2,
        "date_info": {
            "type": "day",
            "value": "2026-02-01"
        }
    },
     "orderby": [
      {
        "field": "day3_units_sold",
        "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á
day3_units_sold	integer	Sản lượng bán 3 ngày
day3_gmv	integer	Doanh thu 3 ngày
total_units_sold	integer	Tổng sản lượng bán
total_gmv	integer	Tổng doanh thu
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": "1732296548196717129",
                "day3_units_sold": 1862,
                "day3_gmv": 31937.01,
                "is_fully_managed": 0,
                "is_cross_border": 1,
                "total_units_sold": 1862,
                "total_gmv": 31470.65,
                "off_shelves": 0,
                "launch_time": 1773924919,
                "title": "Artificial Flowers for Outdoor Indoor Garden Home Decoration, Plastic Faux Flowers, Faux Flower Daisy with Eucalyptus Leaves Fake Plants Greenery Boxwood Porch Patio",
                "cover": "https://s.500fd.com/tt_product/7a113ce6dc2643498eb16d7a3b5fc789~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg",
                "region": "US",
                "currency": "USD",
                "real_price": "$16.24",
                "commission_rate": 1200,
                "category": {
                    "l1": {
                        "id": 10,
                        "name": "Home Supplies"
                    },
                    "l2": {
                        "id": 852104,
                        "name": "Home Decor"
                    },
                    "l3": {
                        "id": 700654,
                        "name": "Decorative Flowers, Plants & Fruit"
                    }
                },
                "shop": {
                    "avatar": "https://s.500fd.com/tt_shop/0f34e8c185dd479ab7e796acd52a5b51~tplv-fhlh96nyum-resize-png:300:300.png",
                    "seller_id": "7494146835918194249",
                    "name": "Gubercen",
                    "total_units_sold": 57263,
                    "is_fully_managed": null
                }
            }
    ]
  }
}