FastMoss OpenAPI

简体中文

English

简体中文

English

Appearance

Video Search ​

简介 ​

通过视频标题或达人 unique_id 搜索视频信息，支持以下功能：

  • 支持模糊搜索
  • 支持设置过滤参数
  • 支持自定义结果排序方式

接口 ​

bash
    POST /video/v1/search

request body ​

字段类型必选描述
keywordsstring否搜索关键词
filterobject否过滤参数
orderbyobject否排序参数
search_afterarray否深度分页参数，与page参数二选一，分页查询数据总条数超过6万时需要用这个参数，下一页的参数值从上一页数据data.sort获取
pageinteger否页码，默认值：1,page * pagesize 不能大于60000
pagesizeinteger否每页条数，默认值：10,最大:100
langstring否语言设置，仅支持以下语种，英语(默认值)：EN_US 印尼语： ID_ID 日语：JA_JP 泰语：TH_TH 越南语：VI_VN 西班牙语：ES_ES 法语：FR_FR 葡萄牙语：PT_BR 中文：ZH_CN

keywords 参数说明 ​

  • 最大长度：120 字符
  • 默认值：空字符串

filter 类型object 可选值 ​

字段类型必选描述
publish_time_rangeobject是发布时间范围（时间戳，整数），例如：{'min': 13345241234, 'max': 1567677878787} 本参数为必填，时间范围不能超过90天
regionstring否国家/地区，例如：['US', 'GB', 'MX', 'ES', 'ID', 'VN', 'MY', 'TH', 'PH']
category_idinteger否达人分类 ID
follower_count_rangeobject否粉丝量区间，例如：{'min': 1, 'max': 100}
play_count_rangeobject否播放量区间，例如：{'min': 1, 'max': 100}
digg_count_rangeobject否点赞量区间，例如：{'min': 1, 'max': 100}
interact_rate_rangeobject否互动率区间，例如：{'min': 1, 'max': 100}
is_ecommerce_creatorboolean否是否为带货达人

orderby 类型string 可选值 ​

字段必选描述
follower_count否粉丝数（降序）
create_time否发布时间（降序）
play_count否播放量（降序）
digg_count否点赞数（降序）
interact_rate否互动率（降序）

request example ​

bash
使用 page + pagesize分页
curl 'https://openapi.test.fastmoss.com/video/v1/search?&timestamp=XXX&access_token=XXX&sign=XXX' \
--header 'Content-Type: application/json' \
{
    "keywords": "hello",
    "filter": {
        "region": "US", 
        "publish_time_rane": {"min": 1678092800, "max": 1678697600}, 
        "category_id": 12, 
        "follower_count_range": {"min": 1000, "max": 100000}, 
    },
    "orderby": "follower_count",
    "page": 1,
    "pagesize": 10
}
bash
深度分页
curl 'https://openapi.test.fastmoss.com/video/v1/search?&timestamp=XXX&access_token=XXX&sign=XXX' \
--header 'Content-Type: application/json' \
{
    "keywords": "hello",
    "filter": {
        "region": "US", 
        "publish_time_rane": {"min": 1678092800, "max": 1678697600}, 
        "category_id": 12, 
        "follower_count_range": {"min": 1000, "max": 100000}, 
    },
    "orderby": "follower_count",
    "search_after": [43500000],
    "pagesize": 10
}

response body ​

data.has_more ​

  • 类型：integer
  • 描述：是否有下一页数据，1是0否

data.list ​

字段类型描述
video_idinteger视频 ID
descstring视频描述
uidstring达人UID
is_adinteger广告标识，1是广告，0不是
regionstring国家/地区标识
create_timeinteger视频发布时间，时间戳格式(秒)
comment_countinteger评论数
play_countinteger播放数
digg_countinteger点赞数
share_countinteger分享数
forward_countinteger收藏数
durationinteger视频长度（秒）
coverstring视频封面 URL
interact_rateinteger互动率 (如10表示10%)
create_datedatetime发布时间（YYYY-MM-DD HH:mm:ss格式）
is_ecommerceinteger是否带货视频（1是，0否）
video_urlstringTikTok视频链接
sold_countinteger带货销量
sale_amountinteger带货销售额
creatorobject达人信息
product_infoarray[object]带货商品列表

data.list.creator 达人信息 ​

字段类型描述
uidinteger达人 ID
avatarstring头像 URL
unique_idstring达人唯一 ID
nicknamestring昵称
regionstring国家/地区
category_idinteger达人分类id
category_namestring达人分类名称
follower_countinteger粉丝数

data.list.product_info 带货商品列表 ​

字段类型描述
product_idstring商品 ID
titlestring商品名称
coverstring商品封面图
regionstring商品国家/地区
currencystring货币代码（如：USD）
pricestring商品售价
sold_countinteger商品销量
sale_amountinteger商品销售额
category_idinteger商品分类id
category_namestring商品分类名称
sourcestring来源，目前只有"TikTok Shop"
detail_urlstring商品详情页地址

data.sort 类型 array排序值 ​

  • 使用search_after深度分页时，往下翻一页需要传上一页返回的这个值

response example ​

json
{
    "code": 0,
    "data": {
        "has_more": 1,
        "list": [
            {
                "id": "7517469614079610142",
                "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",
                "create_time": 1750297310,
                "duration": 5,
                "play_count": 20600000,
                "share_count": 378200,
                "digg_count": 3800000,
                "comment_count": 16400,
                "forward_count": 264159,
                "interact_rate": 20.36,
                "create_date": "2025-06-19 09:41:50",
                "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": "时尚穿搭",
                    "follower_count": 28188
                },
                "sold_count": 2,
                "sale_amount": 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",
                        "sold_count": 2,
                        "sale_amount": 103.92,
                        "category_id": 3,
                        "category_name": "男装与男士内衣",
                        "source": "TikTok Shop",
                        "detail_url": "https://shop.tiktok.com/view/product/1730186290864034458?region=US&local=en"
                    }
                ]
            }
        ],
        "sort": [
            20600000
        ]
    },
    "message": "",
    "timestamp": 1750745256,
    "request_id": "7885f669-27e0-bdb2-1140-b6742978f5f1"
}