Video Search

Introduction

Filter video through keywords or filtering conditions, supporting the following features:

• Supports fuzzy search
• Supports setting filter parameters
• Supports custom result sorting

API Endpoint

    POST /video/v1/search

Request Body

Field	Type	Required	Description
keywords	string	No	Search keywords
filter	object	No	Filter parameters
orderby	object	No	Sorting parameters
page	integer	No	Page number, default: 1
pagesize	integer	No	Items per page, default: 10
lang	string	No	Language settings, English (default): EN_US, Chinese: ZH_CN

page * pagesize <= 5000

pagesize range [1,100]

keywords Details

• Maximum length: 120 characters
• Default: Empty string

filter Type object Optional Values

Field	Type	Required	Description
region	string	No	Country/Region
is_ecommerce	boolean	No	Whether it is an e-commerce video (1: Yes)
creator_category_id	integer	No	Creator category ID
product_category_id	integer	No	Product l1 category ID
create_time_range	object	Yes	Publish time range
follower_count_range	object	No	Follower count range, e.g., {'min': 100000, 'max': 500000}
play_count_range	object	No	Play count range, e.g., {'min': 100000, 'max': 500000}
digg_count_range	object	No	Like count range, e.g., {'min': 100000, 'max': 500000}
interact_rate_range	object	No	Engagement rate range, e.g., {'min': 10, 'max': 20} (10%-20%)

region range: ['US','GB','MX','ES','DE','IT','FR','ID','VN','MY','TH','PH','BR','JP','SG']

orderby Optional Values

Field	Required	Description
follower_count	No	Follower count (descending)
create_time	No	Publish time (descending)
play_count	No	Play count (descending)
digg_count	No	Like count (descending)
units_sold	No	Units sold (descending)
interact_rate	No	Engagement rate (descending)

Request Example

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
}'

Response Body

data.total

Total number of results

data.list

Field	Type	Description
video_id	integer	Video ID
desc	string	Video description
uid	string	Creator UID
is_ad	integer	Advertisement flag, 1 for ad, 0 for non-ad
region	string	Country/Region code
publish_time	integer	Video publish time, timestamp (seconds)
comment_count	integer	Number of comments
play_count	integer	Number of plays
digg_count	integer	Number of likes
share_count	integer	Number of shares
forward_count	integer	Number of favorites
duration	integer	Video duration (seconds)
cover	string	Video cover URL
interact_rate	float	Engagement rate (e.g., 10 means 10%) (deprecated)
interact_rate_info	object	Engagement rate details
is_ecommerce	integer	E-commerce video flag (1 for yes, 0 for no)
video_url	string	TikTok Video URL
units_sold	integer	Number of products sold
gmv	float	Sales amount
creator	object	Creator information
product_info	array[object]	List of products

data.list.creator Creator information

Field	Type	Description
uid	integer	Creator ID
avatar	string	Avatar URL
unique_id	string	Creator unique ID
nickname	string	Nickname
region	string	Country/Region code
category	object	Creator category
follower_count	integer	Number of followers

data.list.product_info Product List

Field	Type	Description
product_id	string	Product ID
title	string	Product name
cover	string	Product cover image
region	string	Product country/region code
currency	string	Currency code (e.g., USD)
price	string	Product price
units_sold	integer	Product sales volume
gmv	float	Product sales amount
category	object	Product category {"l1":{"id": 12, "name": "Beauty"}}
source	string	Source, currently only "TikTok Shop"
detail_url	string	Product detail page URL

Response Example

{
  "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"
}