ログイン無料トライアルを開始
easyCoexistence 公式 API

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 アカウントのフォロワー属性を読み取ります。

100

TikTok が年齢・性別・国・都市の内訳を返すために必要なフォロワー数。

5 groups

audience_ages の年齢層: 18-24、25-34、35-44、45-54、55+。

UTC+0

audience_activity のタイムゾーン。TikTok 上で活動しているフォロワー数を時間ごとに集計したものです。

24 to 48 h

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 日分が返されます:

Follower demographics for a TikTok account
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 の公式例で、性別のリストと数時間分のみに絞っています:

Demographics in the /business/get/ response
{
  "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 のリストをそのまま返すため、割合と時間は上記の通りに読み取れます。

Follower demographics through MCP
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 フォロワー以上のアカウントに限られます。
EasyCoexistence で実現する

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 監視

確認日