Xếp hạng cửa hàng - Bán chạy nhất

Giới thiệu

Lấy dữ liệu xếp hạng doanh số của cửa hàng TikTok, với các tính năng sau:

• Hỗ trợ thiết lập tham số lọc
• Hỗ trợ sắp xếp kết quả tùy chỉnh

Endpoint API

    POST /shop/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
shop_type	integer	Không	Loại cửa hàng: 1 (Cửa hàng thương hiệu), 2 (Cửa hàng bán lẻ)
is_cross_border	integer	Không	Có xuyên biên giới: 1 (Có), 0 (Không)
date_info	object	CÓ	Thông tin ngày

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	Doanh số (giảm dần)
usd_gmv	Không	Doanh thu (giảm dần)

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/shop/v1/rank/topSelling' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "region": "US",
        "category_id": 14,
        # "shop_type": 1,
        # "is_cross_border": 1,
        "date_info": {
            "type": "day",
            "value": "2026-04-01"
        },
        # "date_info": {
        #     "type": "week",
        #     "value": "2026-05"
        # },
        # "date_info": {
        #     "type": "month",
        #     "value": "2026-03"
        # }
    },
    "orderby": [
      {
        "field": "units_sold",
        "order": "desc",
      }
      # ,
      # {
      #   "field": "usd_gmv",
      #   "order": "desc",
      # }
    ],
    "page": 1,
    "pagesize": 10
}'

Phần thân phản hồi

data.total

Tổng số mục trong kết quả.

data.list

Trường	Kiểu	Mô tả
shop_info	object	Thông tin cửa hàng
rank_category	object	Danh mục xếp hạng
total_affiliate_count	integer	Tổng số nhà sáng tạo liên kết
sale_product_count	integer	Sản phẩm đang bán
units_sold	integer	Số đơn vị bán
gmv	integer	Doanh thu bán hàng (GMV)
usd_gmv	integer	Doanh thu tính bằng USD
units_sold_inc_rate	string	Tỷ lệ tăng trưởng doanh số
gmv_inc_rate	string	Tỷ lệ tăng trưởng doanh thu
currency	string	Tiền tệ

Ví dụ phản hồi

{
  "code": 0,
  "data": {
    "list": [
      {
        "shop_info": {
          "seller_id": 7496304415144774132,
          "name": "medicube UK",
          "brand": "",
          "seller_company": "",
          "avatar": "https://s.500fd.com/tt_shop/26ecba0b60364ec2a9cfc0eefe829db5~tplv-t5fjg24jzw-resize-png:300:300.png",
          "region": "GB",
          "currency": "GBP",
          "product_count": 51,
          "shop_rating": 5,
          "main_category": {
            "category_id": 14,
            "name": "Beauty & Personal Care"
          },
          "is_fully_managed": 0,
          "is_cross_border": 0,
          "shop_type": 1,
          "status": 1
        },
        "rank_category": { "category_id": 0, "name": "" },
        "total_affiliate_count": 7986,
        "sale_product_count": 53,
        "units_sold": 5769,
        "gmv": 64774.72,
        "usd_gmv": 80320.65,
        "units_sold_inc_rate": "10.75%",
        "gmv_inc_rate": "7.73%",
        "currency": "GBP"
      }
    ],
    "total": 500,
    "date_type": "day",
    "date_value": "2026-04-06"
  },
  "message": "",
  "timestamp": 1775701062,
  "request_id": "f273e537-f858-9e03-c15a-22a2acc672e9"
}