Xếp hạng sản phẩm - Fully Managed

Giới thiệu

Lấy các sản phẩm Fully Managed, 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/fullyManaged

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', 'GB', 'ES', 'MX', 'DE', 'IT', 'FR']

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
gmv	Không	Doanh thu
units_sold_growth_rate	Không	Tỷ lệ tăng trưởng sản lượng bán

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/product/v1/rank/fullyManaged' \
--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": "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á
units_sold	integer	Sản lượng bán
gmv	integer	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": "1732235069991130057",
                "units_sold": 3543,
                "gmv": 29265.18,
                "units_sold_growth_rate": 59335,
                "off_shelves": 0,
                "launch_time": 1773016184,
                "title": "Women's Short Sleeve Casual Sporty Set, 2-Piece Women's Fashionable Daily Wear & Active Lifestyle Clothing, Stretchy Suit Set, Yoga Gym Outfits",
                "cover": "https://s.500fd.com/tt_product/39c25acb1f364785a1ae23e994606fdc~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg",
                "region": "US",
                "currency": "USD",
                "real_price": "$21.24",
                "commission_rate": 800,
                "category": {
                    "l1": {
                        "id": 2,
                        "name": "Womenswear & Underwear"
                    },
                    "l2": {
                        "id": 842760,
                        "name": "Women's Suits & Overalls"
                    },
                    "l3": {
                        "id": 601291,
                        "name": "Sets"
                    }
                },
                "shop": {
                    "avatar": "https://s.500fd.com/tt_shop/a8f76a9787734bd8b125e71f66a265e2~tplv-aphluv4xwc-resize-png:300:300.png",
                    "seller_id": "8646927642708317129",
                    "name": "Verve Fashion",
                    "total_units_sold": 130881,
                    "is_fully_managed": null
                }
            }
    ]
  }
}