透過 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 的列表。
帳戶須有一定粉絲數,TikTok 才會回傳其年齡、性別、國家及城市細分。
audience_ages 中的年齡組別:18-24、25-34、35-44、45-54 及 55+。
audience_activity 的時區,為按小時計算、在 TikTok 上活躍的粉絲人數。
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 天數據:
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 才會提供;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 的列表,因此佔比與小時數與上文完全一致。
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 位以上的帳戶回傳此數據。
每個連接每月 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 監察
驗證日期