登入開始免費試用
easyCoexistence 官方 API

透過 API 取得 TikTok 受眾人口統計

TikTok for Business API 會從 GET /business/get/ 回傳某個 TikTok 帳戶的粉絲人口統計,即 audience_ages、audience_genders、audience_countries 及 audience_cities,每項均為粉絲佔比的列表,適用於粉絲數至少 100 的帳戶。每小時粉絲活躍度以 audience_activity 形式包含於每日 metrics 中,適用於具備 Advanced Access 或 Verified Business Accounts 且粉絲數同樣為 100 以上的帳戶。以上所有欄位均需要 user.insights 範圍。

easyCoexistence 透過 Claude、ChatGPT 或您自己的代碼,以 get_social_insights 讀取 TikTok 帳戶的粉絲人口統計:請求 audience_ages、audience_genders、audience_countries、audience_cities 或 audience_activity,它會原樣回傳 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 離線計算。

帳戶端點會回傳哪些人口統計數據?

GET /business/get/ 在 fields 中指定相關欄位時會回傳這些數據。四項細分位於 data 頂層,每個維度一個列表;每小時活躍度則位於 metrics 中,每日一組:

  • 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 天;若省略,TikTok 會回傳截至請求日前一天的 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 才會提供;TikTok 針對 13 名粉絲帳戶的範例中,這些列表皆為空。audience_activity 同樣需要 100 位粉絲,此外還需帳戶具備 Advanced Access(可透過連結 TikTok for Business 帳戶或未經驗證的 Business Center 取得),或為 Verified Business Accounts。以上每個欄位都需要 token 上的 user.insights 範圍。

人口統計數據的更新速度如何?

通常落後一至兩天。TikTok 將 audience_countries、audience_genders 及 audience_activity 列為通常延遲 24 至 48 小時的欄位(以 UTC 計),年齡及城市的更新時間與之相同。數據來自 TikTok Analytics,擁有者須在發布首條影片後於應用程式中開啟該功能,此前的數據無法提供。TikTok 會綜合多項因素計算人口統計,包括用戶在個人資料中填寫的內容。

粉絲人口統計與影片觀眾有何不同?

兩者描述的是不同的人。帳戶列表涵蓋粉絲;/business/video/list/ 則回傳看過單一貼文的人的細分:audience_genders、audience_countries 及 audience_cities(各最多 10 項),以及 audience_types,將觀眾分為新觀眾與回頭觀眾,以及粉絲與非粉絲。這些需要 video.insights 範圍,而非 user.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 完成這項設定

每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費試用。

常見問題

TikTok API 能顯示我粉絲的年齡及性別嗎?

能。在帳戶擁有至少 100 位粉絲且 token 具備 user.insights 範圍時,/business/get/ 會回傳 audience_ages 及 audience_genders,即各組別中粉絲的佔比。

TikTok API 採用哪些年齡組別?

18-24、25-34、35-44、45-54 及 55+,每組均附有其中粉絲的佔比。

TikTok API 能顯示我的粉絲何時在線嗎?

audience_activity 會在每日 metrics 中,以 UTC+0 按小時提供在 TikTok 上活躍的粉絲數,適用於具備 Advanced Access 或 Verified Business Accounts 且粉絲達 100 位或以上的帳戶。

TikTok API 如何提供粉絲所在國家?

以 ISO 3166-1 alpha-2 國家或地區代碼形式列於 audience_countries 中,每個代碼附有來自該地區的粉絲佔比。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期