tiktok/
trending-feed

地域コードを指定して現在の公開TikTok動画フィードを収集し、動画ID、キャプション、クリエイター、カバー画像、タイムスタンプ、表示中のエンゲージメントを返します。

TikTok Trending Feed API

地域別フィード
正規化された動画
現在のスナップショット
結果1件あたり0.7クレジット
準備完了
README

SocQ 編集 · 更新

TikTok Trending Feed

TikTokトレンドフィードの動画は、地域ごとのコンテキストで公開されているフィードの項目で、動画とクリエイターの識別情報、キャプション、カバー画像、タイムスタンプ、表示中のエンゲージメントを含みます。これらのコンテンツ・パフォーマンス情報は、地域別の発見スナップショット、クリエイティブ調査、特定時点の比較に活用できます。

TikTok Trending Feed API の主な機能

  • 地域別の公開フィード空でない region の値を受け付け、その地域のリクエストコンテキストで公開されている現在の動画フィードを収集します。
  • 正規化された動画とクリエイターの詳細動画IDとソースURL、キャプション、クリエイターのアカウント情報、カバー画像の参照、作成日時と取得日時を、一貫したレコードで返します。
  • 表示中のエンゲージメント指標返される各動画について、公開されている再生数、いいね数、コメント数、シェア数、保存数をまとめて保持します。
  • 上限付きの現在スナップショットソース側の続きのページはたどらず、地域フィードの1回分のレスポンスを results_limit で切り出します。順位や過去の推移ではなく、現在のフィードのサンプルを保持します。

TikTok Trending Feed API のパラメータ

パラメータ必須説明
region必須必須。空でない region の値です。バックエンドで前後の空白が除去され大文字に変換されます。対象とする地域には US のような標準的な2文字の地域コードを使用してください。
results_limit任意任意。4〜2,000の整数で指定する上限で、デフォルトは100です。1回分のフィードレスポンスを切り出すため、これより少ない動画数になることがあります。

TikTok Trending Feed API の使い方

地域フィードのリクエストを非同期タスクとして送信し、タスク結果のカーソルによるページネーションで正規化された動画を読み取ります。

  1. 空でない region の値を入力します。対象とする地域には US のような標準的な2文字コードを使用し、results_limit は4〜2,000の範囲で選ぶか、デフォルトの100のままにします。
  2. region と results_limit を /v1/tiktok/trending-feed に POST し、返された task_id を保存します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 から data.results.items を読み取り、results.has_more が true の間は results.next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/trending-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"US","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

TikTok Trending Feed API の主なユースケース

  • 地域別の発見スナップショットの記録: 1回の地域フィードリクエストから得た動画ID、ソースURL、キャプション、クリエイター、collected_at を保存し、取得時点で公開されていた動画群を記録します。
  • 現在のクリエイティブ傾向のサンプリング: キャプション、クリエイター名、カバー画像、作成日時を確認し、選択した地域フィードで見られるクリエイティブの構成を比較します。
  • 表示中のエンゲージメントの比較: 再生数、いいね数、コメント数、シェア数、保存数を collected_at とあわせて使い、返された動画間で公開エンゲージメントを比較します。

TikTok Trending Feed API 活用のヒント

  • 現在のランタイムでは空でない値であれば受け付けますが、標準的な2文字の地域コードを使用してください。バックエンドで空白が除去され大文字に変換されます。
  • このエンドポイントは1回分のフィードレスポンスを切り出すだけで、ソース側の続きのページはリクエストしないため、results_limit は期待件数ではなく上限として設定してください。
  • region はフィードの取得コンテキストとして扱い、動画の発信地の証拠とはみなさないでください。extra.region は行単位のデータで、空の場合やリクエストと異なる場合があります。
  • タスク結果のカーソルは、SocQが保存済みのレコードをページ送りするためだけに使用してください。地域フィードの別ページを取得するものではありません。
  • フィードに含まれる動画や順序はリクエストごとに変わる可能性があるため、繰り返し実行した結果を比較する際は動画の id で重複を排除し、collected_at を保持してください。
  • クリエイターのフィールド、指標、カバーメディア、タイムスタンプ、extra の値は null になりうるものとして扱い、公開キャプションは表示前にエスケープしてください。

TikTok Trending Feed API 以外に別の種類の公開TikTokデータが必要な場合は、これらのAPIをご利用ください。

  • TikTok Comments API — 公開トップレベルコメント、投稿者、エンゲージメント、メンション、クリエイターとのやり取りを示すフラグを取得します。
  • TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
  • TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
  • TikTok Video Transcript API — 公開動画のURLから、取得可能な文字起こしテキスト、言語、形式、取得元の情報を抽出します。
  • TikTok Song API — クリップIDまたは音楽URLから、公開サウンドのメタデータを取得します。
  • TikTok Song Videos API — 指定したサウンドIDを使用している公開動画を取得します。

他のプラットフォームを見る

TikTokのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Trending Feed API — よくある質問

TikTok Trending Feed APIは、空でない region の値に対して公開されている現在のTikTok動画フィードを収集するためのプログラムインターフェースです。正規化された動画の識別情報、キャプション、クリエイター、カバー画像、タイムスタンプ、表示中のエンゲージメントに加え、公開されている場合は行単位の地域や広告の情報を返します。

空でない region の値を指定してください。バックエンドで前後の空白が除去され大文字に変換されます。現在のランタイムでは2文字の形式は強制されませんが、公開ドキュメントとソースのインターフェースでは想定される地域入力がそのように定義されているため、US のような標準的な2文字コードを使用してください。

results_limit はデフォルトが100で、4〜2,000の整数を指定できます。返された地域フィードの1回分のレスポンスを切り出すため、上限を大きくしてもソース側の続きのページは取得されず、その件数の動画が得られることも保証されません。

レコードには、動画IDとソースURL、キャプション、クリエイターのID・ユーザー名・表示名、表示中の再生数・いいね数・コメント数・シェア数・保存数、カバー画像1点、作成日時と取得日時に加え、extra.region と extra.is_ad が含まれる場合があります。

わかりません。region はリクエストにおけるフィードの取得コンテキストを制御するもので、クリエイターの所在地や動画の発信地を示すものではありません。extra.region は行ごとに提供され、空の場合や異なる場合があります。

返しません。現在公開されているフィードの動画を返すもので、正規化された順位、順位変動、ハッシュタグの集計、クリエイターランキング、楽曲ランキング、過去の推移のフィールドは含まれません。比較を行う場合は、繰り返し実行したタスクの出力を collected_at とともに保存してください。

正常に保存された正規化動画1件につき0.7クレジットで、タスクの基本料金はかかりません。初期見積もりには results_limit またはデフォルトの100が使われ、使われなかった前払いクレジットはタスクの精算時に返金されます。