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つ以上の公開TikTokユーザー名を用意し、latest または popular の並び順、任意の2文字の region、ユーザー名ごとの results_limit を選びます。
- usernames と任意の制御パラメータを /v1/tiktok/user-videos に 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/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が永続的だとは想定しないでください。
関連API
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 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 Song Videos 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