tiktok/
user-videos

1つ以上のユーザー名から公開TikTok動画を収集し、キャプション、クリエイター、メディア、タイムスタンプ、表示中のエンゲージメントを、アカウントに紐付いた正規化レコードとして返します。

TikTok User Videos API

既知アカウントのフィード
複数ユーザー名の一括指定
取得元アカウントの情報
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

TikTok User Videos

TikTokユーザーの動画は、プロフィールフィードに公開された投稿で、キャプション、クリエイターのアカウント情報、メディアとサウンドの情報、公開情報、表示中のエンゲージメントを含みます。これらのアカウントに紐付いたコンテンツレコードは、クリエイターのコンテンツ一覧、投稿状況の比較、クリエイティブ調査、パフォーマンスのスナップショットに活用できます。

TikTok User Videos API の主な機能

  • 既知アカウントのプロフィールフィード1つ以上のTikTokユーザー名を受け付け、それぞれの公開動画フィードを個別に巡回します。キーワードやハッシュタグによる発見ではなく、選択したアカウントに範囲を絞った結果を返します。
  • 動画とクリエイターの詳細動画IDとURL、キャプション、言語、クリエイターのアカウント情報、メディアの参照、再生時間、ハッシュタグ、メンション、音楽、公開コンテンツフラグを返します。
  • タイムスタンプ付きのエンゲージメント指標表示中の再生数、いいね数、コメント数、シェア数、保存数、リポスト数を公開日時・取得日時と組み合わせ、特定時点のアカウント動画レコードとして提供します。
  • アカウントごとの制御された巡回各ユーザー名に latest または popular の並び順と任意の region を適用し、動画IDの重複排除とアカウントごとの上限を適用します。

TikTok User Videos API のパラメータ

パラメータ必須説明
usernames必須必須。1つ以上の公開TikTokユーザー名のリストです。各値の先頭の @ は付けても省略してもかまいません。
results_limit任意ユーザー名ごとに取得する動画の最大数です。デフォルトは100で、20〜2,000の整数を指定できます。
sort_by任意任意のプロフィールフィードの並び順です。デフォルトは latest で、popular を指定するとソース側のランキング順になります。
region任意任意の2文字の地域コードです。大文字で渡され、ソース側で取得できる動画に影響します。

TikTok User Videos API の使い方

既知の公開ユーザー名を非同期タスクとして送信し、アカウントに紐付いた正規化動画を結果カーソルによるページネーションで読み取ります。

  1. 1つ以上の公開TikTokユーザー名を用意し、latest または popular の並び順、任意の2文字の region、ユーザー名ごとの results_limit を選びます。
  2. usernames と任意の制御パラメータを /v1/tiktok/user-videos に 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/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@loganpaul"],"results_limit":20,"sort_by":"latest"}'

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

TikTok User Videos API の主なユースケース

  • クリエイターの動画一覧: 選択したアカウントを動画ID、正規URL、キャプション、メディア、公開日時、extra.input_username でインデックス化し、追跡可能な公開コンテンツのカタログを維持します。
  • 投稿状況とエンゲージメントの比較: collected_at をスナップショット日時として保持しながら、既知のアカウント間で created_at と表示中の再生数、いいね数、コメント数、シェア数、保存数、リポスト数を比較します。
  • クリエイティブフォーマットの調査: キャプション、言語、再生時間、ハッシュタグ、メンション、音楽、メディア種別、公開コンテンツフラグを使い、選択したプロフィールフィードで繰り返し見られるクリエイティブの傾向を比較します。

TikTok User Videos API 活用のヒント

  • creator と @creator は同じアカウントを指しますが、別々に処理される可能性があるため、送信前にすべてのハンドルを1つの形式に正規化して重複を排除してください。
  • 上限と初期のクレジット見積もりは送信したアカウントごとに個別に適用されるため、ユーザー名の数を考慮して results_limit を選んでください。
  • 新しさを重視した収集には latest を使い、popular はSocQが計算したスコアではなくソース側の並び順として扱ってください。
  • region は取得可否の制御としてのみ使用し、返された動画がその地域で制作されたことの証拠とは解釈しないでください。
  • 繰り返し実行したタスクを統合する場合は、動画の id で重複を排除しつつ、アカウントの帰属とスナップショット日時のために extra.input_username と collected_at を保持してください。
  • 任意のクリエイター、エンゲージメント、メディア、音楽、コンテンツフラグのフィールドは null になりうるものとして扱い、公開キャプションは表示前にエスケープし、ソースのメディアURLが永続的だとは想定しないでください。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Comments API — 公開トップレベルコメント、投稿者、エンゲージメント、メンション、クリエイターとのやり取りを示すフラグを取得します。
  • TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
  • TikTok Trending Feed API — 地域ごとの現在の公開動画フィードを取得し、クリエイター、キャプション、カバー、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。
  • TikTok Video Transcript API — 公開動画のURLから、取得可能な文字起こしテキスト、言語、形式、取得元の情報を抽出します。
  • TikTok Song API — クリップIDまたは音楽URLから、公開サウンドのメタデータを取得します。

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

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

TikTok User Videos API — よくある質問

TikTok User Videos APIは、1つ以上のTikTokユーザー名から公開プロフィールフィードの動画を収集するためのプログラムインターフェースです。正規化された動画の識別情報、キャプション、クリエイターとメディアの情報、タイムスタンプ、表示中のエンゲージメント、取得元のユーザー名を返します。

usernames を空でない配列として送信してください。先頭の @ は受け付けますが、送信前にハンドルを正規化して重複を排除すると、同じアカウントを複数回処理するのを避けられます。

results_limit はユーザー名ごとの最大数で、20〜2,000の範囲で指定でき、デフォルトは100です。各プロフィールフィードは個別に巡回され、最大数に達する前に終了することもあります。

latest はデフォルトのプロフィールフィードの並び順で、popular はソース側のランキング順の結果をリクエストします。popular はSocQが計算したスコアではないため、タスクの出力を比較する際は選択した並び順を記録しておいてください。

region には任意で2文字のコードを指定でき、ソース側で取得できる動画に影響する場合があります。動画が制作された場所やオーディエンスの所在地を示すものではありません。

レコードには、動画の識別情報とURL、キャプションと言語、クリエイターの詳細、表示中のエンゲージメント、メディアと再生時間、ハッシュタグ、メンション、音楽、タイムスタンプ、公開コンテンツフラグ、extra.input_username が含まれる場合があります。

返されるのは公開プロフィールフィードで公開されている動画のみです。非公開、制限付き、削除済み、非表示の動画は含まれないことがあり、フィードが終端に達した場合、カーソルが進まなくなった場合、または100ページの上限に達した場合にも収集は停止します。

保存された正規化動画1件につき0.5クレジットで、タスクの基本料金はかかりません。初期見積もりは results_limit またはそのデフォルト値にユーザー名の数を掛けて計算され、最終的な使用量は実際に保存されたレコード数に基づきます。保存された動画がない場合、結果に対する課金は発生しません。