tiktok/
user-audience

公開TikTokアカウントのユーザー名だけで、フォロワーが住む国を取得できます。国名、ISOコード、オーディエンスに占める割合、サンプルのフォロワー数を返します。

TikTok Audience Demographics API

ユーザー名を入力
フォロワーの国
国ごとの割合
1リクエストあたり20クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Audience Demographics

TikTokアカウントのオーディエンスの国別分布は、フォロワーのサンプルに占める各国の割合と、その割合の元になったサンプルのフォロワー数で表されます。TikTok標準のアナリティクスでこの画面を見られるのはアカウントの持ち主だけなので、自分で運用していないクリエイターを調べるブランド、代理店、アナリストには、ユーザー名で照会する方法が向いています。

TikTok Audience Demographics API の主な機能

  • 公開ユーザー名だけ、ログイン不要@の有無を問わず公開ユーザー名を送るだけで、アカウントへのアクセス権やTikTokのセッションがなくても、フォロワーの国別分布を取得できます。
  • 国名・ISOコード・割合・人数audience_countries の各要素には、国名、2文字の country_code、0〜1の割合、その割合の元になったサンプルのフォロワー数が入ります。
  • 最大の市場が先頭国は割合の大きい順に並ぶので、先頭の数行でオーディエンスの大半がどこにいるかがわかり、後ろの行からは規模の小さい市場も確認できます。

TikTok Audience Demographics API のパラメータ

パラメータ必須説明
username必須分析するTikTokのユーザー名です。先頭の@は付けても付けなくてもかまいません。

TikTok Audience Demographics API の使い方

ユーザー名を送信し、タスクをポーリングして、1件のオーディエンスレコードを読み取ります。

  1. {"username": "khaby.lame"} を /v1/tiktok/user-audience に POST します。
  2. status が succeeded になるまで、数秒おきに GET /v1/tasks/{task_id} をポーリングします。
  3. results.items の1件のレコードを読み取り、audience_countries を順に処理します。
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame"}'

# The result has one record; audience_countries[].share is a fraction from 0 to 1.

TikTok Audience Demographics API の主なユースケース

  • 特定の国向けのクリエイター起用判断: 1つの国を狙ったキャンペーンに費用をかける前に、その国がクリエイターのフォロワーに占める割合を確認します。フォロワーが多くても居住地が別の国なら、販売先の顧客には届きません。
  • 地域ターゲティング施策の効果確認: 新しい国でオーディエンスを増やしたいときは、同じユーザー名を定期的に照会し、collected_at の時点ごとにその国の割合を比べます。
  • 対応できない市場の除外: 販売先の国が決まっているショップやアプリは、対象国の country_code の割合を合計して、フォロワーの大半が対象外の国にいるクリエイターを候補から外せます。

TikTok Audience Demographics API 活用のヒント

  • count を割合で割ると、フォロワーサンプルの大きさがわかります。サンプルが小さいときは、割合が近い国に順位をつけず、同程度として扱ってください。
  • クリエイターを比べる前に、country_code をEUやLATAMなど独自の地域にまとめておくと便利です。キャンペーンは1つの国ではなく、地域を対象にすることが多いためです。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Followers List API — 公開フォロワーリストに表示されているプロフィールを正規化して取得し、取得元の情報と対応する指標を保持します。
  • TikTok Following List API — TikTokアカウントがフォローしている公開プロフィールを、正規化されたアカウント情報、プロフィール文、表示中の指標、元のアカウント情報とともに取得します。
  • TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
  • TikTok Similar Accounts API — ユーザー名に似ているとしてTikTokがおすすめするアカウントを、フォロワー数とプロフィール文とともに探します。
  • TikTok Live Ranking API — LIVEのデイリークリエイターランキングを、順位、ギフトにもとづくスコア、フォロワー数とともに取得します。

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

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

TikTok Audience Demographics API — よくある質問

TikTok Audience Demographics APIは、ユーザー名から公開TikTokアカウントのフォロワーがいる国を取得するためのプログラムインターフェースです。各国の国名、ISOコード、オーディエンスに占める割合、サンプルのフォロワー数を並べた1件のレコードを返します。

はい、公開アカウントならどれでも見られます。TikTokがフォロワーの所在地を表示するのはアカウントの持ち主だけですが、この照会に必要なのはユーザー名だけです。

いいえ。レコードに含まれるのはフォロワーの国だけで、年齢、性別、都市の内訳はありません。

はい。自分のユーザー名を送れば、TikTokアナリティクスを開かなくても国別のデータとして読み取れます。複数のアカウントを運用していて、レポートにまとめたいときに向いています。

各割合はアカウントのフォロワーのサンプルから算出されていて、count はその割合の元になったサンプルのフォロワー数です。count が小さい国の割合は、正確な値ではなくおおまかな目安として見てください。

リクエスト単位です。返ってくる国の数にかかわらず、1ユーザー名につき一律20クレジットで、存在しないユーザー名ではタスクが失敗し、クレジットは返却されます。