Tìm kiếm video

Giới thiệu

Lọc video qua từ khóa hoặc điều kiện lọc, hỗ trợ các tính năng sau:

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

Endpoint API

    POST /video/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
lang	string	Không	Cài đặt ngôn ngữ, tiếng Anh (mặc định): EN_US, tiếng Trung: ZH_CN

page * pagesize <= 5000

pagesize khoảng [1,100]

Chi tiết keywords

• Độ dài tối đa: 120 ký tự
• Mặc định: Chuỗi rỗng

Giá trị tùy chọn của filter kiểu object

Trường	Kiểu	Bắt buộc	Mô tả
region	string	Không	Quốc gia/Khu vực
is_ecommerce	boolean	Không	Có phải video TMĐT không (1: Có)
creator_category_id	integer	Không	ID danh mục nhà sáng tạo
product_category_id	integer	Không	ID danh mục l1 sản phẩm
create_time_range	object	Có	Khoảng thời gian đăng
follower_count_range	object	Không	Khoảng số người theo dõi, ví dụ {'min': 100000, 'max': 500000}
play_count_range	object	Không	Khoảng số lượt phát, ví dụ {'min': 100000, 'max': 500000}
digg_count_range	object	Không	Khoảng số lượt thích, ví dụ {'min': 100000, 'max': 500000}
interact_rate_range	object	Không	Khoảng tỷ lệ tương tác, ví dụ {'min': 10, 'max': 20} (10%-20%)

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ả
follower_count	Không	Số người theo dõi (giảm dần)
create_time	Không	Thời gian đăng (giảm dần)
play_count	Không	Số lượt phát (giảm dần)
digg_count	Không	Số lượt thích (giảm dần)
units_sold	Không	Số đơn vị bán (giảm dần)
interact_rate	Không	Tỷ lệ tương tác (giảm dần)

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/video/v1/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    # "keywords": "test",
    "filter": {
        "region": "US",
        "is_ecommerce": 1,
        "creator_category_id": 4,
        "product_category_id": 12,
        "follower_count_range": {"min": 1000, "max": 100000},
        # "create_time_range": {"min": 1678092800, "max": 1678697600},
        # "interact_rate_range": {"min": 10, "max": 20},
    },
    "orderby": [{"field":"follower_count", "order":"desc"}],
    # "orderby": [{"field":"create_time", "order":"desc"}],
    # "orderby": [{"field":"interact_rate", "order":"desc"}],
    # "orderby": [{"field":"play_count", "order":"desc"}],
    # "orderby": [{"field":"digg_count", "order":"desc"}],
    # "orderby": [{"field":"units_sold", "order":"desc"}],
    "page": 1,
    "pagesize": 10
}'

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

data.total

Tổng số kết quả

data.list

Trường	Kiểu	Mô tả
video_id	integer	ID video
desc	string	Mô tả video
uid	string	UID nhà sáng tạo
is_ad	integer	Cờ quảng cáo, 1 là quảng cáo, 0 là không
region	string	Mã quốc gia/khu vực
publish_time	integer	Thời gian đăng video, timestamp (giây)
comment_count	integer	Số bình luận
play_count	integer	Số lượt phát
digg_count	integer	Số lượt thích
share_count	integer	Số lượt chia sẻ
forward_count	integer	Số lượt yêu thích
duration	integer	Thời lượng video (giây)
cover	string	URL ảnh bìa video
interact_rate	float	Tỷ lệ tương tác (ví dụ 10 nghĩa là 10%) (đã ngừng dùng)
interact_rate_info	object	Chi tiết tỷ lệ tương tác
is_ecommerce	integer	Cờ video TMĐT (1 là có, 0 là không)
video_url	string	URL video TikTok
units_sold	integer	Số sản phẩm đã bán
gmv	float	Số tiền bán
creator	object	Thông tin nhà sáng tạo
product_info	array[object]	Danh sách sản phẩm

data.list.creator Thông tin nhà sáng tạo

Trường	Kiểu	Mô tả
uid	integer	ID nhà sáng tạo
avatar	string	URL ảnh đại diện
unique_id	string	ID duy nhất của nhà sáng tạo
nickname	string	Biệt danh
region	string	Mã quốc gia/khu vực
category	object	Danh mục nhà sáng tạo
follower_count	integer	Số người theo dõi

data.list.product_info Danh sách sản phẩm

Trường	Kiểu	Mô tả
product_id	string	ID sản phẩm
title	string	Tên sản phẩm
cover	string	Ảnh bìa sản phẩm
region	string	Mã quốc gia/khu vực sản phẩm
currency	string	Mã tiền tệ (ví dụ USD)
price	string	Giá sản phẩm
units_sold	integer	Sản lượng bán sản phẩm
gmv	float	Số tiền bán sản phẩm
category	object	Danh mục sản phẩm {"l1":{"id": 12, "name": "Beauty"}}
source	string	Nguồn, hiện chỉ có "TikTok Shop"
detail_url	string	URL trang chi tiết sản phẩm

Ví dụ phản hồi

{
  "code": 0,
  "data": {
    "total": 2437,
    "list": [
      {
        "video_id": "7517469614079610142",
        "desc": "#fyp #foryou #relatable #xyzbca #blowthisup ",
        "uid": "6764812635147207685",
        "is_ad": 0,
        "cover": "https://s.500fd.com/tt_video/ogoJVwT1ZBfI2AFR9EkI8uLCpUE9AHfturaDEt~tplv-tiktokx-cropcenter-q:300:400:q72.jpeg",
        "region": "US",
        "publish_time": 1750297310,
        "duration": 5,
        "play_count": 20600000,
        "share_count": 378200,
        "digg_count": 3800000,
        "comment_count": 16400,
        "forward_count": 264159,
        "interact_rate": 20.36, // deprecated
        "interact_rate_info": {
          "rate": 20.36,
          "unit": "%"
        },
        "is_ecommerce": 1,
        "video_url": "https://www.tiktok.com/@seenontiktokltd/video/7516849526523858199",
        "creator": {
          "uid": "6764812635147207685",
          "avatar": "https://s.500fd.com/tt_author/d19f10b759f11d0043878ed0acbeae7f~tplv-tiktokx-cropcenter:1080:1080.jpeg",
          "nickname": "Julz",
          "unique_id": "julzgeekin",
          "region": "US",
          "category_id": 6,
          "category_name": "Fashion",
          "follower_count": 28188
        },
        "units_sold": 2,
        "gmv": 103,
        "product_info": [
          {
            "product_id": "1730186290864034458",
            "title": "Pacsun Men's Escape Reality Zip Up Hoodie",
            "cover": "https://s.500fd.com/tt_product/97468f66b806475a9a16bcfc03826bc1~tplv-omjb5zjo8w-crop-webp:500:500.webp",
            "region": "US",
            "currency": "USD",
            "price": "$51.96",
            "units_sold": 2,
            "gmv": 103.92,
            "category": {
              "l1": {
                "id": 3,
                "name": "Men's Clothing"
              }
            },
            "source": "TikTok Shop",
            "detail_url": "https://shop.tiktok.com/view/product/1730186290864034458?region=US&local=en"
          }
        ]
      }
    ]
  },
  "message": "",
  "timestamp": 1750745256,
  "request_id": "7885f669-27e0-bdb2-1140-b6742978f5f1"
}