TikTok Reposts
TikTokのリポストとは、アカウントが他のクリエイターの動画をフォロワーに共有する機能で、その一覧を見ると、アカウントがどんなコンテンツを広めたいと考えているかがわかります。ユーザー名でこの一覧を読み取れば、クリエイター同士の関係の把握、ブランドの推奨状況の確認、本人の投稿だけではわからない関心の把握ができます。
TikTok Reposts API の主な機能
- 公開ユーザー名からリポストを取得ユーザー名を送ると、そのアカウントのリポスト一覧にある動画が新しい順に返ります。TikTokへのログインは不要です。
- 元の投稿者とリポストしたアカウントを区別author には、リポストしたアカウントではなく、動画を作ったクリエイターのユーザー名、表示名、アバター、認証フラグが入ります。
- 動画ごとの内容とエンゲージメントリポストごとに、キャプション、ハッシュタグ、メンション、再生数、いいね数、コメント数、シェア数、再生時間に加え、サウンドのタイトルとアーティスト名が付きます。
- 動画ファイルとサムネイルの参照media に動画URL、サムネイル、幅、高さ、長さが入るので、レスポンスだけでリポストのプレビューやアーカイブができます。
TikTok Reposts API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
username | 必須 | リポストを取得するTikTokのユーザー名です。先頭の@は付けても付けなくてもかまいません。 |
results_limit | 任意 | 取得するリポスト動画の件数です。1〜500の範囲で指定し、デフォルトは20です。 |
TikTok Reposts API の使い方
ユーザー名を送信し、そのリポストをページごとに取得します。
- {"username": "mrbeast", "results_limit": 20} を /v1/tiktok/user-reposts に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 も見ると、クリエイターが繰り返しリポストするテーマやサウンドがつかめます。
関連API
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 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 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 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