透過 API 取得 TikTok 追蹤者數與個人檔案資料
TikTok 的 API for Business 會透過 GET /business/get/ 以 followers_count 回傳帳戶的追蹤者數,並同時回傳 username、display_name、profile_image、bio_description、is_verified、following_count、total_likes 與 videos_count,每個欄位都需要相應的權限範圍,例如 user.info.stats。Display API 的 /v2/user/info/ 則會為已授權該應用程式的用戶,以 follower_count 回傳相同的數字。
easyCoexistence 讓你透過 Claude、ChatGPT 或自己的程式碼,以 get_social_insights 讀取 TikTok 帳戶的個人檔案與追蹤者數:指定 followers_count、total_likes 或 videos_count 等欄位,若需每日數據則加上日期,並原樣回傳 TikTok 的數字。
/business/get/ 頂部列出 followers_count、following_count、total_likes 與 videos_count 所需的權限範圍。
TikTok 更新 followers_count 與個人檔案欄位的方式,而每日指標通常於 24 至 48 小時後才會提供。
/v2/user/info/ 中 Display API 對該數字的名稱,以及其獨立的 user.info.stats 權限範圍。
/business/get/ 中每日 followers_count 及其他每日指標可回溯的最長時段。
請求未指定任何欄位時,/business/get/ 只回傳 display_name 與 profile_image。
/business/get/ 會回傳哪些個人檔案欄位?
由 fields 指定的欄位,即查詢字串中的 JSON 陣列,每個欄位都需要帳戶擁有者在授權應用程式時授予相應的權限範圍才會解鎖。請求未指定欄位時,只會取得 display_name 與 profile_image。TikTok 會即時更新以下的個人檔案與數字欄位:
如何請求追蹤者數?
以 GET 請求 /business/get/,在 Access-Token 標頭中帶入帳戶的存取權杖,並附上 business_id(即權杖交換時取得的 open_id),以及所需的欄位。目前數字位於 data 頂部,每日數字則位於 metrics 中:
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=["display_name","followers_count","following_count","is_verified","daily_new_followers","daily_lost_followers"]'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"display_name": "<DISPLAY_NAME>",
"followers_count": 13,
"following_count": 2,
"is_verified": false,
"metrics": [
{ "date": "<DATE>", "followers_count": 13, "daily_new_followers": 0, "daily_lost_followers": 0 }
]
}
}如何逐日追蹤追蹤者數?
在 fields 中指定 followers_count 後,TikTok 會回傳兩次:data 頂部為累計總數,屬於 user.info.stats;metrics 內每日的總數屬於 user.insights。start_date 與 end_date 以 UTC 時間指定日期,最多可回溯 60 天;若未提供,TikTok 會回傳請求日前一天為止的 7 天數據。對於具備 Advanced Access 或 Verified Business Account 的帳戶,另外三個每日欄位可顯示總數背後的變動:
daily_new_followers:當日新增的追蹤者數。daily_lost_followers:當日流失的追蹤者數。daily_total_followers:當日淨增長,即新增減去流失。
Display API 會回傳什麼?
為已授權 TikTok for Developers 應用程式的用戶,透過 GET https://open.tiktokapis.com/v2/user/info/ 回傳同類的個人檔案,所需欄位列於 fields 參數中。其名稱與權限範圍有別於 API for Business,而其 user 物件不包含每日歷史數據:
| API for Business: /business/get/ | Display API: /v2/user/info/ | |
|---|---|---|
| Followers | followers_count | follower_count |
| Following | following_count | following_count |
| Likes | total_likes | likes_count |
| Videos | videos_count | video_count |
| Count scope | user.info.stats | user.info.stats |
| Username scope | user.info.username | user.info.profile |
| Photo | profile_image | avatar_url, avatar_url_100, avatar_large_url |
| Daily history | Up to 60 days in metrics | Not in the user object |
能否讀取其他帳戶的追蹤者數?
這兩個端點都做不到。/business/get/ 只會回應已授權應用程式的帳戶所對應的 business_id,/v2/user/info/ 則只回應以該權杖發出請求的用戶。TikTok 的 Research API 設有 /v2/research/user/info/ 端點,接受用戶名稱並回傳 follower_count、following_count、likes_count 與 video_count,但僅限 TikTok 批准的研究人員使用。
easyCoexistence 如何讀取個人檔案?
透過 get_social_insights,不帶 object_id 查詢該帳戶:metrics 中的名稱會成為 /business/get/ 的欄位,params 中的 start_date 與 end_date 用來指定日期,結果則為 TikTok 原始回傳的數據。若 metrics 清單為空,則會取得用戶名稱、顯示名稱、頭像、追蹤者數、正在追蹤數、讚好數與影片數、兩個帳戶層級標記,以及每日影片觀看次數、個人檔案瀏覽次數及新增追蹤者。list_social_accounts 亦會顯示帳戶連接時儲存的用戶名稱與顯示名稱。
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["followers_count", "following_count", "total_likes", "videos_count"],
"params": { "start_date": "2026-10-02", "end_date": "2026-10-31" }
}常見錯誤
- 在權杖上未授予 user.info.stats 就請求 followers_count。TikTok 只有在擁有者授予相應權限範圍時才會回傳各欄位,因此擁有者必須重新授權應用程式。
- 儲存 profile_image 以備日後使用。它是一個暫時網址,到期時間列於 x-expires 參數中,因此需要時應重新取得。
- 從 /business/get/ 讀取 follower_count。那是 Display API 的名稱;API for Business 稱之為 followers_count。
- 以為個人帳戶會有每日新增與流失的追蹤者數。TikTok 只對具備 Advanced Access 或 Verified Business Account 的帳戶回傳這些每日欄位。
每個連接每月由 US$ 9 降至 US$ 0.75,連接越多越便宜,首 3 天免費。
常見問題
TikTok API 能顯示追蹤者增長的時間趨勢嗎?
可以,最多回溯 60 天:metrics 中可取得每日的 followers_count,而在 Advanced Access 或 Verified Business Account 下,還可取得每日新增、流失及淨追蹤者數。
TikTok 追蹤者數需要哪個權限範圍?
user.info.stats,兩個 API 都適用:它會解鎖 /business/get/ 中的 followers_count,以及 Display API 的 /v2/user/info/ 中的 follower_count。
個人 TikTok 帳戶能取得追蹤者數嗎?
可以。followers_count 取決於權限範圍,而非帳戶級別;只有部分每日欄位需要 Advanced Access 或 Verified Business Account。
TikTok 追蹤者數多久更新一次?
頂層的 followers_count 標示為即時更新,而 metrics 中的每日資料通常延遲 24 至 48 小時才會提供,並以 UTC 時間計算。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期