tiktok/
user-reposts

ユーザー名だけで、公開TikTokアカウントがリポストした動画を取得できます。元の投稿者、キャプション、再生数、いいね数、ハッシュタグ、動画ファイルを動画ごとに返します。

TikTok Reposts API

ユーザー名を入力
動画ごとの元の投稿者
新しいリポスト順
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Reposts

TikTokのリポストとは、アカウントが他のクリエイターの動画をフォロワーに共有する機能で、その一覧を見ると、アカウントがどんなコンテンツを広めたいと考えているかがわかります。ユーザー名でこの一覧を読み取れば、クリエイター同士の関係の把握、ブランドの推奨状況の確認、本人の投稿だけではわからない関心の把握ができます。

TikTok Reposts API の主な機能

  • 公開ユーザー名からリポストを取得ユーザー名を送ると、そのアカウントのリポスト一覧にある動画が新しい順に返ります。TikTokへのログインは不要です。
  • 元の投稿者とリポストしたアカウントを区別author には、リポストしたアカウントではなく、動画を作ったクリエイターのユーザー名、表示名、アバター、認証フラグが入ります。
  • 動画ごとの内容とエンゲージメントリポストごとに、キャプション、ハッシュタグ、メンション、再生数、いいね数、コメント数、シェア数、再生時間に加え、サウンドのタイトルとアーティスト名が付きます。
  • 動画ファイルとサムネイルの参照media に動画URL、サムネイル、幅、高さ、長さが入るので、レスポンスだけでリポストのプレビューやアーカイブができます。

TikTok Reposts API のパラメータ

パラメータ必須説明
username必須リポストを取得するTikTokのユーザー名です。先頭の@は付けても付けなくてもかまいません。
results_limit任意取得するリポスト動画の件数です。1〜500の範囲で指定し、デフォルトは20です。

TikTok Reposts API の使い方

ユーザー名を送信し、そのリポストをページごとに取得します。

  1. {"username": "mrbeast", "results_limit": 20} を /v1/tiktok/user-reposts に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からリポスト動画を読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/user-reposts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"mrbeast","results_limit":20}'

# author on each item is the video's original creator.

TikTok Reposts API の主なユースケース

  • アカウントが広めている相手を把握: クリエイターのリポストをまたいで author.username を集計すると、よくシェアしている相手がわかり、本人の投稿との好みの違いも見えてきます。
  • アンバサダーが自社ブランドをリポストしているか確認: 提携しているクリエイターのリポストを集め、投稿者が自社ブランドのアカウントになっている件数を数えます。
  • 競合ブランドが広めているコンテンツの確認: 競合ブランドのアカウントのリポストを取得して、フォロワーにどのコンテンツを紹介しているか、どのハッシュタグやサウンドが繰り返し出てくるかを調べます。
  • 拡散されやすいクリップの発見: リポスト動画を shares_count と views_count で並べ替えて、他のアカウントが次々に共有しているコンテンツを見つけます。

TikTok Reposts API 活用のヒント

  • クリエイター同士の関係図は、ユーザー名ではなく author.id をキーにして作ってください。ユーザー名は変更されることがあります。
  • metrics は動画そのものの数値として読んでください。リポストしたアカウントのリーチではなくクリップ全体の成績を示すもので、このリポスト経由で何人が見たかはわかりません。
  • author の顔ぶれだけでなく hashtags と audio.title も見ると、クリエイターが繰り返しリポストするテーマやサウンドがつかめます。

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

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

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

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

TikTok Reposts API — よくある質問

TikTok Reposts APIは、ユーザー名から公開TikTokアカウントがリポストした動画を収集するためのプログラムインターフェースです。各動画のキャプション、元のクリエイター、エンゲージメント数、ハッシュタグ、サウンド、動画ファイルの参照を返します。

はい。公開アカウントのリポストはユーザー名だけで読み取れるため、TikTokへのログインは不要で、ご自身のTikTokアカウントに紐づく操作もありません。

いいえ。リポストされた動画ごとに返るのは再生数、いいね数、コメント数、シェア数で、視聴した人が誰かはわかりません。

結果が空なのは、そのアカウントに公開されているリポストがないということです。タスクは成功として扱われ、課金されません。

author です。ここに入るのは動画を公開したクリエイターで、リポスト一覧を取得した対象のアカウントではありません。そのため、同じ投稿者が1つの一覧に何度も現れることがあります。

いいえ。published_at は元の動画が投稿された日時で、リポストした日時ではありません。一覧はアカウントのリポスト順に並び、新しいリポストが先頭に来ます。

最大500件で、デフォルトは20件です。has_more が true の間は next_cursor で続きを取得できます。返されたリポスト動画1件につき0.5クレジットです。