ライブ配信ランキング - 人気商品トップ
概要
TikTokライブ配信の人気商品ランキングデータを取得します。
- フィルターパラメータの設定が可能
- カスタムソート順に対応
API エンドポイント
bash
POST /live/v1/rank/topProductリクエストボディ
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
filter | object | いいえ | フィルターパラメータ |
orderby | object | いいえ | ソートパラメータ |
page | integer | いいえ | デフォルト: 1 |
pagesize | integer | いいえ | デフォルト: 10 |
page*pagesize<= 500
pagesize範囲 [1, 100]
filter オプション値
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
region | string | いいえ | 国/地域 |
category_id | integer | いいえ | 商品カテゴリ（レベル1） |
date_info | object | はい | 日付情報: 日次、週次、月次 |
region範囲:['US','GB','MX','ES','DE','IT','FR','PT','NL','BE','AT','PL','ID','VN','MY','TH','PH','BR','JP','SG']
orderby オプション値
| フィールド | 必須 | 説明 |
|---|---|---|
units_sold | いいえ | 販売数（降順） |
gmv | いいえ | 売上（降順） |
live_count | いいえ | ライブ配信数（降順） |
リクエスト例
bash
curl 'https://openapi.fastmoss.com/live/v1/rank/topProduct' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
"filter": {
"region": "US",
"category_id": 14,
# "date_info": {
# "type": "day",
# "value": "2026-04-01"
# },
"date_info": {
"type": "week",
"value": "2026-13"
}
# ,
# "date_info": {
# "type": "month",
# "value": "2026-04"
# }
},
"orderby": [
{
"field": "units_sold",
"order": "desc",
}
],
"page": 1,
"pagesize": 10
}'レスポンスボディ
data.total
結果の総数
data.list
| フィールド | 型 | 説明 |
|---|---|---|
product | object | 商品情報 |
shop | object | ショップ情報 |
top_live | array[object] | トップ販売ライブ配信 |
units_sold | integer | ライブ配信販売数 |
gmv | integer | ライブ配信売上 |
usd_gmv | integer | ライブ配信売上（USD） |
currency | string | 通貨 |
live_count | integer | ライブ配信数 |
data.list:product
| フィールド | 型 | 説明 |
|---|---|---|
product_id | string | 商品ID |
title | string | 商品タイトル |
cover | string | 商品カバーURL |
real_price | string | 商品価格 |
currency | string | 通貨 |
region | string | 国/地域 |
category | object | 商品カテゴリ |
data.list:product:category
| フィールド | 型 | 説明 |
|---|---|---|
l1 | object | レベル1カテゴリ |
l2 | object | レベル2カテゴリ |
l3 | object | レベル3カテゴリ |
data.list:shop
| フィールド | 型 | 説明 |
|---|---|---|
seller_id | string | ショップID |
name | string | ショップ名 |
region | string | 国/地域 |
avatar | string | ショップロゴURL |
data.list:top_live
| フィールド | 型 | 説明 |
|---|---|---|
room_id | string | ライブルームID |
title | string | ライブ配信タイトル |
cover | string | ライブ配信カバーURL |
gmv | integer | ライブ配信売上 |
units_sold | integer | ライブ配信販売数 |
currency | string | 通貨 |
region | string | 国/地域 |
レスポンス例
json
{
"code": 0,
"data": {
"list": [
{
"product": {
"product_id": "1729707172352594230",
"title": "BASED Leave-in Conditioner | Instant Hydration & Anti-Frizz | Simple, Effective, BASED.",
"cover": "https://s.500fd.com/tt_product/413c08135c3f48e480af5dd9aa5f60c2~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg",
"region": "US",
"currency": "USD",
"real_price": "$17.00",
"category": {
"l1": {
"id": 14,
"name": "Beauty & Personal Care"
},
"l2": {
"id": 848904,
"name": "Haircare & Styling"
},
"l3": {
"id": 601469,
"name": "Shampoo & Conditioner"
}
}
},
"shop": {
"seller_id": "7495079418085345590",
"name": "BASED",
"avatar": "https://s.500fd.com/tt_shop/c4e48f5ff0b242968e1d6212f3ab93f0~tplv-omjb5zjo8w-resize-png:300:300.png",
"region": "US"
},
"rank_category": {
"category_id": "14",
"name": "Beauty & Personal Care"
},
"top_live": [
{
"room_id": "7619504259826060063",
"title": "Spring Glow Up LIVE",
"region": "US",
"cover": "https://s.500fd.com/tt_live/55014e26dbf474c4a27a302cea499131~tplv-tiktokx-cropcenter:720:720.jpeg",
"gmv": 14075,
"units_sold": 563,
"currency": "USD"
},
{
"room_id": "7619504259826060063",
"title": "Spring Glow Up LIVE",
"region": "US",
"cover": "https://s.500fd.com/tt_live/55014e26dbf474c4a27a302cea499131~tplv-tiktokx-cropcenter:720:720.jpeg",
"gmv": 13850,
"units_sold": 554,
"currency": "USD"
}
],
"live_units_sold": 2985,
"live_gmv": 74625,
"live_usd_gmv": 74625,
"live_count": 17
}
],
"total": 500,
"date_type": "week",
"date_value": "2026-13"
},
"message": "",
"timestamp": 1777355755,
"request_id": "7582c9e8-dc04-101a-5d39-cdd032716713"
}