TikTok動画の詳細を取得（リアルタイム）

TikTokから単一の動画を直接収集し、呼び出し時点の完全なメタデータとエンゲージメント数を返します。アカウント全体ではなく個別コンテンツの追跡に適しています。

GET/api/v1/tiktok/realtime/video/detail

クォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 100 単位消費されます。

プラットフォーム共通パス

/api/v1/{platform}/realtime/video/detail

利用可能なプラットフォーム

リクエストパラメータ

必須パラメータ

名前	位置	型	説明
`video_id`	query	string	Video ID example: 7447950131443469614
`region`	query	string	country code:US,VN... example: US

レスポンスフィールド

名前	型	説明
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.video_id`	string	Video ID
`data.description`	string	Video description
`data.create_at`	string	Publish time
`data.author_uid`	string	Author UID
`data.author_unique_id`	string	Author unique_id
`data.author_nickname`	string	Author nickname
`data.duration`	number	Video duration
`data.share_count`	integer	Share count
`data.like_count`	integer	Like count
`data.comment_count`	integer	Comment count
`data.play_count`	integer	Play count
`data.collect_count`	integer	Save count

お試し実行

リクエストURL

https://openapi.scdata.cc/api/v1/tiktok/realtime/video/detail

Authorization

ダッシュボードのAPIキーを選択

リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く

クエリパラメータ

video_id*

region*

cURL の例

bash

curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/realtime/video/detail?video_id=7447950131443469614&region=US" \
  -H "Authorization: YOUR_API_KEY"

レスポンス例 (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "video_id": "string",
    "description": "string",
    "create_at": "2019-08-24T14:15:22.123Z",
    "author_uid": "string",
    "author_unique_id": "string",
    "author_nickname": "string",
    "duration": 0,
    "video_url": "string",
    "cover_url": "string",
    "share_count": 0,
    "like_count": 0,
    "comment_count": 0,
    "play_count": 0,
    "collect_count": 0
  }
}

ユースケース

スポンサーコンテンツ報告 — キャンペーン総括レポート用にスポンサー動画の最終数値を取得します。
バイラルコンテンツ監視 — 急成長中の動画を一定間隔で再取得し、拡散速度を計測します。