Tìm kiếm sản phẩm

Giới thiệu

Lấy thông tin sản phẩm TikTok Shop theo từ khóa hoặc điều kiện lọc, với các tính năng sau:

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

Endpoint API

POST /product/v1/search

Phần thân yêu cầu

Trường	Kiểu	Bắt buộc	Mô tả
keywords	string	Không	Từ khóa tìm kiếm
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 <= 5000

pagesize khoảng [1, 100]

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

Trường	Kiểu	Bắt buộc	Mô tả
l1_category_id	integer	Không	ID danh mục cấp 1
l2_category_id	integer	Không	ID danh mục cấp 2
l3_category_id	integer	Không	ID danh mục cấp 3
region	string	Không	Quốc gia/Khu vực
seller_id	string	Không	ID cửa hàng
product_id	mix	Không	ID sản phẩm, string hoặc array
commission_rate_range	object	Không	Khoảng tỷ lệ hoa hồng, ví dụ {'min': 1, 'max': 10}
price_range	object	Không	Khoảng giá sàn sản phẩm, ví dụ {'min': 1, 'max': 10}. Phải dùng kèm region hoặc seller_id vì đơn vị giá khác nhau theo khu vực
creator_count_range	object	Không	Khoảng số nhà sáng tạo, ví dụ {'min': 1, 'max': 10}
units_sold_range	object	Không	Khoảng sản lượng bán, ví dụ {'min': 1, 'max': 10}
is_sshop	boolean	Không	Có phải sản phẩm cửa hàng Fully Managed không (đã ngừng dùng)
shop_type	integer	Không	Loại cửa hàng: 1 (Nội địa), 2 (Xuyên biên giới) (đã ngừng dùng)
is_cross_border	boolean	Không	Có phải sản phẩm xuyên biên giới không
is_fully_managed	boolean	Không	Có phải sản phẩm Fully Managed không
is_new_listed	boolean	Không	Có phải sản phẩm mới niêm yết không
is_free_shipping	boolean	Không	Có phải sản phẩm miễn phí vận chuyển không
is_local_warehouse	boolean	Không	Có phải sản phẩm kho nội địa không
is_top_selling	boolean	Không	Có phải sản phẩm bán chạy nhất không
off_shelves	integer	Không	Trạng thái sản phẩm: 0 (đang bán), 1 (đã gỡ)
promotion_channel	integer	Không	Kênh quảng bá: 1 (video), 2 (trực tiếp), 3 (video & trực tiếp)
launch_time_range	object	Không	Khoảng thời gian ra mắt sản phẩm (timestamp Unix)
creator_order_rate_range	object	Không	Khoảng tỷ lệ đặt hàng của nhà sáng tạo, [0,100]
total_gmv_range	object	Không	Khoảng tổng GMV (cần chỉ định region; số tiền theo đơn vị tiền tệ của khu vực)
day7_units_sold_range	object	Không	Khoảng số lượng bán trong 7 ngày
day7_gmv_range	object	Không	Khoảng GMV trong 7 ngày (cần chỉ định region; số tiền theo đơn vị tiền tệ của khu vực)

Bộ lọc khoảng dùng định dạng { "min": ..., "max": ... } (xem units_sold_range trong bảng trên).

launch_time_range nhận timestamp Unix.

Số tiền của total_gmv_range và day7_gmv_range theo đơn vị tiền tệ của region được chỉ định — hãy luôn truyền kèm region với các bộ lọc này.

region: ['US','GB','MX','ES','DE','IT','FR','PT','NL','BE','AT','PL','ID','VN','MY','TH','PH','BR','JP','SG'] lấy danh sách danh mục sản phẩm đầy đủ qua /product/v1/category

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

Trường	Bắt buộc	Mô tả
day7_units_sold	Không	Sản lượng bán 7 ngày (giảm dần)
day7_gmv	Không	Doanh thu 7 ngày (giảm dần)
commission_rate	Không	Tỷ lệ hoa hồng (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)
creator_count	Không	Số nhà sáng tạo liên kết (giảm dần)

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/product/v1/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "keywords": "test",
    "filter": {
        "region": "US",
      "off_shelves": 0,
      "price_range": {
        "min": 10,
        "max": 30
      },
        commission_rate_range: {
            "min": 10,
            "max": 15
        },
        "l1_category_id": 2
        # "product_id": ["1729514474840169156", "1729514474840169156"],
    },
      "orderby": [
      {
        "field": "day7_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	string	Tỷ lệ hoa hồng
creator_order_rate	string	Tỷ lệ đặt hàng của nhà sáng tạo
price	string	Giá sản phẩm
floor_price	float	Giá sàn sản phẩm
off_shelves	integer	Trạng thái sản phẩm: 0 (đang bán), 1 (đã gỡ)
day7_units_sold	integer	Sản lượng bán 7 ngày
day7_gmv	integer	Doanh thu 7 ngày
total_units_sold	integer	Tổng sản lượng bán
total_gmv	integer	Tổng doanh thu
creator_count	integer	Số nhà sáng tạo 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,
  "data": {
    "list": [
      {
        "product_id": "1729514474840169156",
        "title": "HALMAI-taladro de uñas Ultra Power, Lima eléctrica inalámbrica profesional para uñas acrílicas y de Gel, Motor ultrapotente diseñado por HALMAI, sin vibración para el cuidado Natural Superior de las uñas, eliminación de Gel en 10 segundos",
        "region": "ES",
        "creator_count": 101,
        "video_count": 134,
        "category": {
          "l1": {
            "id": 14,
            "name": "Beauty & Personal Care"
          },
          "l2": {
            "id": 849416,
            "name": "Beauty & Personal Care Appliances"
          },
          "l3": {
            "id": 601677,
            "name": "Beauty & Personal Care Appliance Accessories"
          }
        },
        "total_units_sold": 4921,
        "total_gmv": 134661,
        "is_cross_border": 1,
        "commission_rate": "12.5%",
        "yday_sold_count": 0,
        "day7_units_sold": 735,
        "day28_units_sold": 735,
        "day90_units_sold": 3351,
        "creator_order_rate": "12.12%",
        "product_rating": 4.9,
        "is_free_shipping": 1,
        "off_shelves": 0,
        "source": "",
        "price": "29,99 €",
        "floor_price": 29.99,
        "ctime": "2025-06-03 02:19:00",
        "is_sshop": 1,
        "tiktok_url": "",
        "fastmoss_url": "https://www.fastmoss.com/zh/e-commerce/detail/1729514474840169156",
        "sku_count": 4,
        "shop": {
          "seller_id": 123,
          "name": "test",
          "avatar": "xxx",
          "total_units_sold": 123
        }
      }
    ],
    "total": 4
  },
  "message": "",
  "timestamp": 1761820066,
  "request_id": "6b18539b-a04a-fa23-ca03-4144f67cc7eb"
}