TikTok Profiles
TikTokプロフィールは、アカウント情報、プロフィール文、アバター、認証・非公開の状態、表示中のフォロワー数・フォロー数・動画数・いいね数を含む、クリエイターやアカウントの公開ページです。これらのプロフィール情報は、クリエイター発掘、オーディエンス比較、タイアップの事前調査、ディレクトリの情報補完に活用できます。
TikTok Profiles API の主な機能
- 複数ユーザー名の一括検索1回のリクエストで、1つ以上の公開クリエイターのユーザー名を照会できます。
- ユーザー名入力の正規化nasa や @nasa といった形式の入力を、プロフィール取得前に正規化します。
- 安定したプロフィール識別アカウントID、ユーザー名、表示名、プロフィールURLからアカウント識別用のインデックスを構築できます。
- プロフィールとオーディエンスのフィールドプロフィール文、アバター、認証・非公開の状態に加え、フォロワー数・フォロー数・動画数・総いいね数を1件のレコードで返します。
- 追跡可能なプロフィールのスナップショット送信した入力値と collected_at により、情報補完や定期スナップショットをすべて追跡できます。
TikTok Profiles API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
usernames | 必須 | 必須。公開TikTokユーザー名のリストです。各値の先頭の @ は付けても省略してもかまいません。 |
TikTok Profiles API の使い方
クリエイターのユーザー名リストから始めて、ディレクトリやCRMにそのまま使えるレコードを作成します。
- nasa や @nasa といったクリエイターリストの値を正規化し、重複を排除します。
- usernames 配列を /v1/tiktok/profiles に POST し、返された task_id を保存します。
- /v1/tasks/{task_id} をポーリングします。queued と running は通常の中間ステータスです。
- 成功したら data.results.items を読み取ります。has_more が true の場合は next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@tiktok"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Profiles API の主なユースケース
- タレントディレクトリの情報補完: ユーザー名リストを、アカウントID、アバター、プロフィール文、ステータス、規模指標を備えたクリエイターカードに変換します。
- タイアップの準備: アプローチの前に、クリエイターのアカウント情報、投稿実績、オーディエンス規模を確認します。
- クリエイターの成長トラッキング: 固定したクリエイター群について、フォロワー数・動画数・総いいね数のスナップショットを定期的に保存します。
- データセット間のアカウント照合: アカウントIDを使って、クリエイターのレコードを関連する動画やコメントと結び付けます。
TikTok Profiles API 活用のヒント
- id をクリエイターのキーとして使い、username は検索と表示用に保持してください。
- 送信した input を保持しておくと、すべてのAPIレコードを元のタレントリストに正確に対応付けられます。
- 一定の間隔で取得し、各指標のスナップショットを collected_at と組み合わせて保存してください。
- 先頭の @ を取り除いてから、ユーザー名で重複を排除してください。
- avatar、display_name、biography、profile_url を組み合わせると、実用的なクリエイターカードを作成できます。
- 関連するプロフィール、動画、コメントのレコードをアカウントIDで結合すると、クリエイターをより多面的に把握できます。
関連API
TikTok Profiles API 以外に別の種類の公開TikTokデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Followers List API — 公開フォロワーリストに表示されているプロフィールを正規化して取得し、取得元の情報と対応する指標を保持します。
- TikTok Following List API — TikTokアカウントがフォローしている公開プロフィールを、正規化されたアカウント情報、プロフィール文、表示中の指標、元のアカウント情報とともに取得します。
- TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
- TikTok Audience Demographics API — ユーザー名から、クリエイターのフォロワーがどの国にいるかを、各国がオーディエンスに占める割合とともに確認します。
- TikTok Similar Accounts API — ユーザー名に似ているとしてTikTokがおすすめするアカウントを、フォロワー数とプロフィール文とともに探します。
- TikTok Live Ranking API — LIVEのデイリークリエイターランキングを、順位、ギフトにもとづくスコア、フォロワー数とともに取得します。
- TikTok Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript 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 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 Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API