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 の使い方
地域フィードのリクエストを非同期タスクとして送信し、タスク結果のカーソルによるページネーションで正規化された動画を読み取ります。
- 空でない region の値を入力します。対象とする地域には US のような標準的な2文字コードを使用し、results_limit は4〜2,000の範囲で選ぶか、デフォルトの100のままにします。
- region と results_limit を /v1/tiktok/trending-feed に POST し、返された task_id を保存します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /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 になりうるものとして扱い、公開キャプションは表示前にエスケープしてください。
関連API
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 Profiles API
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API