API経由のTikTokオーディエンス属性
TikTok API for Business は、GET /business/get/ からアカウントのフォロワー属性を返します。audience_ages、audience_genders、audience_countries、audience_cities で、いずれもフォロワーの割合のリストです。対象は、フォロワーが 100 人以上のアカウントです。時間帯別のフォロワー活動は、各日の metrics にある audience_activity として返されます。こちらは Advanced Access または Verified Business Accounts のアカウントで、同じく 100 フォロワー以上が条件です。いずれも user.insights スコープが必要です。
easyCoexistence は、Claude、ChatGPT、またはご自身のコードから get_social_insights を使って TikTok アカウントのフォロワー属性を読み取ります。
TikTok が年齢・性別・国・都市の内訳を返すために必要なフォロワー数。
audience_ages の年齢層: 18-24、25-34、35-44、45-54、55+。
audience_activity のタイムゾーン。TikTok 上で活動しているフォロワー数を時間ごとに集計したものです。
audience_countries、audience_genders、audience_activity の通常の遅延。TikTok がオフラインで集計するため、反映まで時間がかかります。
アカウントのエンドポイントはどの属性を返しますか?
fields で指定すると返されます。4 つの内訳は data の上位にあり、次元ごとに 1 つのリストになります。時間帯別の活動は metrics にあり、日ごとに 1 セットずつ入ります:
audience_ages: 年齢層ごとのフォロワーの割合(18-24、25-34、35-44、45-54、55+)。audience_genders: 性別ごとのフォロワーの割合(Female、Male、Other)。audience_countries: 国または地域ごとのフォロワーの割合。ISO 3166-1 alpha-2 コードで表記されます。audience_cities:city_nameごとの都市別フォロワーの割合。audience_activity: 日ごとに、各時間に TikTok で活動しているフォロワー数。hour と count で返されます。
これらのデータはどのようにリクエストしますか?
fields に項目名を JSON 配列で指定します。audience_activity を含む日次 metrics には、UTC での日付範囲を指定します。start_date と end_date は最大 60 日前まで遡れます。省略すると、リクエストの前日までの 7 日分が返されます:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["audience_ages","audience_genders","audience_countries","audience_cities","audience_activity"]' \
--data-urlencode 'start_date=2026-10-24' \
--data-urlencode 'end_date=2026-10-30'レスポンスはどのような形式ですか?
各内訳は、グループとその割合を組にしたオブジェクトのリストです。metrics の各日には日付と、時間ごとの audience_activity リストが含まれます。以下の値は TikTok の公式例で、性別のリストと数時間分のみに絞っています:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"audience_genders": [
{ "gender": "Female", "percentage": 0.7554470336505679 },
{ "gender": "Male", "percentage": 0.24455296634943213 }
],
"metrics": [
{
"date": "<DATE>",
"audience_activity": [
{ "hour": "20", "count": 1 },
{ "hour": "23", "count": 4 },
{ "hour": "7", "count": 4 }
]
}
]
}
}どのアカウントがどの内訳を取得できますか?
年齢・性別・国・都市の割合は、フォロワーが 100 人以上になると返されます。フォロワー 13 人のアカウントについて TikTok が示した例では、これらのリストは空です。audience_activity も 100 フォロワー以上が必要です。加えて、Advanced Access が必要です。これは TikTok for Business アカウントとの連携、または未認証の Business Center との連携で得られます。Verified Business Account でも可能です。これらすべての項目には、トークンに user.insights スコープが必要です。
属性データはどのくらい新しいですか?
1 日から 2 日の遅延があります。TikTok は audience_countries、audience_genders、audience_activity を通常 24 から 48 時間遅れる項目として挙げています。時刻は UTC です。年齢と都市も同じ更新時刻です。データは TikTok Analytics から取得されます。オーナーがアプリで最初の動画を投稿した後に有効化する機能で、それ以前のデータは利用できません。TikTok は属性の算出に、ユーザーがプロフィールに入力した情報を含む複数の要素を用いています。
フォロワーの属性と動画の視聴者は何が違いますか?
それぞれ異なる人々を表します。アカウントの一覧はフォロワーが対象です。/business/video/list/ は、1 つの投稿を視聴した人の内訳を返します。audience_genders、audience_countries、audience_cities はそれぞれ最大 10 件、audience_types は視聴者を新規と再訪、フォロワーと非フォロワーに分けます。これらには user.insights ではなく video.insights スコープが必要です。
easyCoexistence ではどのように読み取りますか?
アカウントに対して get_social_insights を使います。object_id は省略し、項目名を metrics に並べます。特定の日の audience_activity が必要な場合は、params に start_date と end_date を指定します。TikTok のリストをそのまま返すため、割合と時間は上記の通りに読み取れます。
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["audience_ages", "audience_genders", "audience_countries", "audience_cities", "audience_activity"],
"params": { "start_date": "2026-10-24", "end_date": "2026-10-30" }
}よくある間違い
- 小規模アカウントで内訳が返ると期待すること。TikTok は 100 フォロワー以上で年齢・性別・国・都市の割合を返します。フォロワー 13 人の例では、リストは空です。
- audience_activity の時間を現地時間だと読むこと。TikTok は UTC+0 で報告するため、投稿を計画する前にオーディエンスのタイムゾーンへ変換してください。
- フォロワーの属性を視聴者の属性として扱うこと。アカウントの一覧はフォロワーを表し、動画の audience_countries はその動画を視聴した人を表します。
- 個人アカウントで audience_activity を期待すること。TikTok が返すのは、Advanced Access または Verified Business Accounts で、100 フォロワー以上のアカウントに限られます。
audience_ages、audience_genders、audience_countries、audience_cities、audience_activity を指定すると、TikTok のリストをそのまま返します。料金は接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。
よくある質問
TikTok API で、フォロワーの年齢と性別を確認できますか?
はい。/business/get/ は audience_ages と audience_genders を返します。各グループのフォロワーの割合です。アカウントのフォロワーが 100 人以上で、トークンに user.insights がある場合に取得できます。
TikTok API はどの年齢層を使いますか?
18-24、25-34、35-44、45-54、55+ の 5 つです。それぞれにフォロワーの割合が付きます。
TikTok API で、フォロワーがいつオンラインか分かりますか?
audience_activity は、各日の metrics 内で時間ごとに TikTok 上で活動しているフォロワー数を、UTC+0 で返します。Advanced Access または Verified Business Accounts で、100 フォロワー以上のアカウントが対象です。
TikTok API はフォロワーの国をどのように返しますか?
audience_countries に、ISO 3166-1 alpha-2 の国または地域コードで入ります。各コードには、そこからのフォロワーの割合が付きます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日