tiktok/
profiles

1つ以上のユーザー名から公開TikTokプロフィールを取得し、正規化されたアカウント情報、プロフィール文、アバター、アカウントフラグ、表示中のオーディエンス数を返します。

TikTok Profiles API

クリエイターのレコード
アカウントの名寄せ
プロフィールのスナップショット
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Profiles

TikTokプロフィールは、アカウント情報、プロフィール文、アバター、認証・非公開の状態、表示中のフォロワー数・フォロー数・動画数・いいね数を含む、クリエイターやアカウントの公開ページです。これらのプロフィール情報は、クリエイター発掘、オーディエンス比較、タイアップの事前調査、ディレクトリの情報補完に活用できます。

TikTok Profiles API の主な機能

  • 複数ユーザー名の一括検索1回のリクエストで、1つ以上の公開クリエイターのユーザー名を照会できます。
  • ユーザー名入力の正規化nasa や @nasa といった形式の入力を、プロフィール取得前に正規化します。
  • 安定したプロフィール識別アカウントID、ユーザー名、表示名、プロフィールURLからアカウント識別用のインデックスを構築できます。
  • プロフィールとオーディエンスのフィールドプロフィール文、アバター、認証・非公開の状態に加え、フォロワー数・フォロー数・動画数・総いいね数を1件のレコードで返します。
  • 追跡可能なプロフィールのスナップショット送信した入力値と collected_at により、情報補完や定期スナップショットをすべて追跡できます。

TikTok Profiles API のパラメータ

パラメータ必須説明
usernames必須必須。公開TikTokユーザー名のリストです。各値の先頭の @ は付けても省略してもかまいません。

TikTok Profiles API の使い方

クリエイターのユーザー名リストから始めて、ディレクトリやCRMにそのまま使えるレコードを作成します。

  1. nasa や @nasa といったクリエイターリストの値を正規化し、重複を排除します。
  2. usernames 配列を /v1/tiktok/profiles に POST し、返された task_id を保存します。
  3. /v1/tasks/{task_id} をポーリングします。queued と running は通常の中間ステータスです。
  4. 成功したら 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 true

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

  • タレントディレクトリの情報補完: ユーザー名リストを、アカウントID、アバター、プロフィール文、ステータス、規模指標を備えたクリエイターカードに変換します。
  • タイアップの準備: アプローチの前に、クリエイターのアカウント情報、投稿実績、オーディエンス規模を確認します。
  • クリエイターの成長トラッキング: 固定したクリエイター群について、フォロワー数・動画数・総いいね数のスナップショットを定期的に保存します。
  • データセット間のアカウント照合: アカウントIDを使って、クリエイターのレコードを関連する動画やコメントと結び付けます。

TikTok Profiles API 活用のヒント

  • id をクリエイターのキーとして使い、username は検索と表示用に保持してください。
  • 送信した input を保持しておくと、すべてのAPIレコードを元のタレントリストに正確に対応付けられます。
  • 一定の間隔で取得し、各指標のスナップショットを collected_at と組み合わせて保存してください。
  • 先頭の @ を取り除いてから、ユーザー名で重複を排除してください。
  • avatar、display_name、biography、profile_url を組み合わせると、実用的なクリエイターカードを作成できます。
  • 関連するプロフィール、動画、コメントのレコードをアカウントIDで結合すると、クリエイターをより多面的に把握できます。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Profiles API — よくある質問

TikTok Profiles APIは、1つ以上のTikTokユーザー名について、公開されているプロフィールレコードを取得するAPIです。正規化されたアカウント情報、プロフィール文、アバター、認証・非公開フラグ、フォロワー数・フォロー数・動画数・いいね数を返します。

公開ユーザー名を usernames 配列に入れてください。exampleuser と @exampleuser のどちらの形式も受け付けます。

できます。usernames には複数の値を指定でき、同じ非同期タスク内で処理されて、正規化されたプロフィールレコードとして返されます。

結果には、アカウントID、ユーザー名、表示名、プロフィールURL、公開プロフィール文、アバターが含まれ、存在する場合はアカウントステータス、作成日時、地域のフィールドも含まれます。

取得時に確認された、公開表示中のフォロワー数・フォロー数・動画数・総いいね数が含まれます。

指標は collected_at のタイムスタンプ時点の値です。同じアカウントの結果を定期的に保存すると、公開プロフィールのスナップショットを時系列で蓄積できます。

アカウントIDと正規化されたユーザー名を使って、Videos、Search、Hashtags のクリエイターフィールドと Comments の投稿者フィールドを結合します。

返された正規化プロフィール結果1件につき0.6クレジットです。