Pencarian Video

Pendahuluan

Filter video melalui kata kunci atau kondisi pemfilteran, mendukung fitur berikut:

• Mendukung pencarian fuzzy
• Mendukung pengaturan parameter filter
• Mendukung pengurutan hasil khusus

Endpoint API

    POST /video/v1/search

Isi Permintaan

Bidang	Tipe	Wajib	Deskripsi
keywords	string	Tidak	Kata kunci pencarian
filter	object	Tidak	Parameter filter
orderby	object	Tidak	Parameter pengurutan
page	integer	Tidak	Nomor halaman, default: 1
pagesize	integer	Tidak	Item per halaman, default: 10
lang	string	Tidak	Pengaturan bahasa, Inggris (default): EN_US, Mandarin: ZH_CN

page * pagesize <= 5000

rentang pagesize [1,100]

Detail keywords

• Panjang maksimum: 120 karakter
• Default: String kosong

Nilai Opsional filter Tipe object

Bidang	Tipe	Wajib	Deskripsi
region	string	Tidak	Negara/Wilayah
is_ecommerce	boolean	Tidak	Apakah video e-commerce (1: Ya)
creator_category_id	integer	Tidak	ID kategori kreator
product_category_id	integer	Tidak	ID kategori l1 produk
create_time_range	object	Ya	Rentang waktu publikasi
follower_count_range	object	Tidak	Rentang jumlah pengikut, cth., {'min': 100000, 'max': 500000}
play_count_range	object	Tidak	Rentang jumlah pemutaran, cth., {'min': 100000, 'max': 500000}
digg_count_range	object	Tidak	Rentang jumlah suka, cth., {'min': 100000, 'max': 500000}
interact_rate_range	object	Tidak	Rentang tingkat engagement, cth., {'min': 10, 'max': 20} (10%-20%)

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

Nilai Opsional orderby

Bidang	Wajib	Deskripsi
follower_count	Tidak	Jumlah pengikut (menurun)
create_time	Tidak	Waktu publikasi (menurun)
play_count	Tidak	Jumlah pemutaran (menurun)
digg_count	Tidak	Jumlah suka (menurun)
units_sold	Tidak	Unit terjual (menurun)
interact_rate	Tidak	Tingkat engagement (menurun)

Contoh Permintaan

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

Isi Respons

data.total

Jumlah total hasil

data.list

Bidang	Tipe	Deskripsi
video_id	integer	ID Video
desc	string	Deskripsi video
uid	string	UID Kreator
is_ad	integer	Penanda iklan, 1 untuk iklan, 0 untuk non-iklan
region	string	Kode Negara/Wilayah
publish_time	integer	Waktu publikasi video, timestamp (detik)
comment_count	integer	Jumlah komentar
play_count	integer	Jumlah pemutaran
digg_count	integer	Jumlah suka
share_count	integer	Jumlah bagikan
forward_count	integer	Jumlah favorit
duration	integer	Durasi video (detik)
cover	string	URL sampul video
interact_rate	float	Tingkat engagement (cth., 10 berarti 10%) (tidak digunakan lagi)
interact_rate_info	object	Detail tingkat engagement
is_ecommerce	integer	Penanda video e-commerce (1 untuk ya, 0 untuk tidak)
video_url	string	URL Video TikTok
units_sold	integer	Jumlah produk terjual
gmv	float	Jumlah penjualan
creator	object	Informasi kreator
product_info	array[object]	Daftar produk

data.list.creator Informasi kreator

Bidang	Tipe	Deskripsi
uid	integer	ID Kreator
avatar	string	URL Avatar
unique_id	string	ID unik kreator
nickname	string	Nama panggilan
region	string	Kode Negara/Wilayah
category	object	Kategori kreator
follower_count	integer	Jumlah pengikut

data.list.product_info Daftar Produk

Bidang	Tipe	Deskripsi
product_id	string	ID Produk
title	string	Nama produk
cover	string	Gambar sampul produk
region	string	Kode negara/wilayah produk
currency	string	Kode mata uang (cth., USD)
price	string	Harga produk
units_sold	integer	Volume penjualan produk
gmv	float	Jumlah penjualan produk
category	object	Kategori produk {"l1":{"id": 12, "name": "Beauty"}}
source	string	Sumber, saat ini hanya "TikTok Shop"
detail_url	string	URL halaman detail produk

Contoh Respons

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