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件のオーディエンスレコードを読み取ります。
- {"username": "khaby.lame"} を /v1/tiktok/user-audience に POST します。
- status が succeeded になるまで、数秒おきに GET /v1/tasks/{task_id} をポーリングします。
- 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つの国ではなく、地域を対象にすることが多いためです。
関連API
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 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