動画検索

概要

キーワードやフィルター条件で動画を検索します。以下の機能をサポートします。

• あいまい検索に対応
• フィルターパラメータの設定が可能
• カスタムソート順に対応

API エンドポイント

    POST /video/v1/search

リクエストボディ

フィールド	型	必須	説明
keywords	string	いいえ	検索キーワード
filter	object	いいえ	フィルターパラメータ
orderby	object	いいえ	ソートパラメータ
page	integer	いいえ	ページ番号, デフォルト: 1
pagesize	integer	いいえ	1ページあたりの件数, デフォルト: 10
lang	string	いいえ	言語設定, 英語（デフォルト）: EN_US, 中国語: ZH_CN

page * pagesize <= 5000

pagesize 範囲 [1,100]

keywords 詳細

• 最大長: 120 文字
• デフォルト: 空文字列

filter 型 object オプション値

フィールド	型	必須	説明
region	string	いいえ	国/地域
is_ecommerce	boolean	いいえ	Eコマース動画かどうか（1: はい）
creator_category_id	integer	いいえ	クリエイターカテゴリID
product_category_id	integer	いいえ	商品L1カテゴリID
create_time_range	object	はい	公開時間範囲
follower_count_range	object	いいえ	フォロワー数範囲, 例: {'min': 100000, 'max': 500000}
play_count_range	object	いいえ	再生回数範囲, 例: {'min': 100000, 'max': 500000}
digg_count_range	object	いいえ	いいね数範囲, 例: {'min': 100000, 'max': 500000}
interact_rate_range	object	いいえ	エンゲージメント率範囲, 例: {'min': 10, 'max': 20} (10%-20%)

region 範囲: ['US','GB','MX','ES','DE','IT','FR','PT','NL','BE','AT','PL','ID','VN','MY','TH','PH','BR','JP','SG']

orderby オプション値

フィールド	必須	説明
follower_count	いいえ	フォロワー数（降順）
create_time	いいえ	公開時間（降順）
play_count	いいえ	再生回数（降順）
digg_count	いいえ	いいね数（降順）
units_sold	いいえ	販売数（降順）
interact_rate	いいえ	エンゲージメント率（降順）

リクエスト例

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

レスポンスボディ

data.total

結果の総数

data.list

フィールド	型	説明
video_id	integer	動画ID
desc	string	動画の説明
uid	string	クリエイターUID
is_ad	integer	広告フラグ, 1: 広告, 0: 非広告
region	string	国/地域コード
publish_time	integer	動画公開時間, タイムスタンプ（秒）
comment_count	integer	コメント数
play_count	integer	再生回数
digg_count	integer	いいね数
share_count	integer	シェア数
forward_count	integer	お気に入り数
duration	integer	動画時間（秒）
cover	string	動画カバーURL
interact_rate	float	エンゲージメント率（非推奨）
interact_rate_info	object	エンゲージメント率詳細
is_ecommerce	integer	Eコマース動画フラグ（1: はい, 0: いいえ）
video_url	string	TikTok動画URL
units_sold	integer	販売商品数
gmv	float	売上金額
creator	object	クリエイター情報
product_info	array[object]	商品リスト

data.list.creator クリエイター情報

フィールド	型	説明
uid	integer	クリエイターID
avatar	string	アバターURL
unique_id	string	クリエイターのユニークID
nickname	string	ニックネーム
region	string	国/地域コード
category	object	クリエイターカテゴリ
follower_count	integer	フォロワー数

data.list.product_info 商品リスト

フィールド	型	説明
product_id	string	商品ID
title	string	商品名
cover	string	商品カバー画像
region	string	商品の国/地域コード
currency	string	通貨コード（例: USD）
price	string	商品価格
units_sold	integer	商品販売数
gmv	float	商品売上金額
category	object	商品カテゴリ {"l1":{"id": 12, "name": "Beauty"}}
source	string	ソース, 現在は "TikTok Shop" のみ
detail_url	string	商品詳細ページURL

レスポンス例

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