TikTok 分析 API:帳戶洞察與影片指標
TikTok 商業 API 可按日返回帳戶指標,例如追蹤者、影片觀看、主頁瀏覽、讚好、留言及分享,最多可追溯至過去 60 天;每條影片則返回其整個生命週期的累計數字,例如觀看、讚好、留言及分享。大部分數字會延遲 24 至 48 小時才出現,並且須在應用程式中開啟 TikTok 分析功能。
easyCoexistence 可透過 Claude、ChatGPT 或您自己的程式碼,使用 get_social_insights 讀取 TikTok 數據:帳戶的每日追蹤者、觀看及讚好,或影片的觀看、讚好、留言及分享。
帳戶每日指標的最長回溯期;若不指定日期,API 只返回過去 7 天。
每日及每則貼文的數字(如讚好、觀看及分享)通常需要延遲的時間才可提供。
貼文發佈後,其數據停止更新的時限。
帳戶須達到的追蹤者數目,TikTok 才會返回其追蹤者的年齡、性別及地區分佈資料。
有哪些帳戶指標?
GET /business/get/ 會返回帳戶的資料檔案,並在指定日期內返回指標列表,每日一項,以 UTC 計算:
followers_count:目前的總數,以及每日的總數。video_views、profile_views、likes、comments 及 shares:帳戶所有影片每日的累計數字。unique_video_views、daily_new_followers、daily_lost_followers及engaged_audience:按日提供,適用於具備 Advanced Access 或認證商業帳戶的帳戶。audience_ages、audience_genders、audience_countries及audience_cities:追蹤者分佈資料,適用於追蹤者達 100 人或以上的帳戶。
有哪些影片指標?
GET /business/video/list/ 會返回帳戶的公開貼文及其累計數字,不受 60 天回溯期限制,包括 video_views、likes、comments、shares 及 favorites,另有覆蓋人數、總觀看時長及平均觀看時長、完整觀看率、新增追蹤者及流量來源。每頁最多返回 20 則貼文;filters.video_ids 可篩選特定貼文。
數據的時效性如何?
用戶名稱及目前的追蹤者總數等個人資料欄位為即時更新。帳戶每日指標,以及貼文的觀看、讚好、留言及分享等數字,通常延遲 24 至 48 小時(以 UTC 計算);貼文發佈後 365 天,其數據便停止更新。若影片在超過 7 天內沒有被觀看、讚好、留言或分享,其覆蓋人數、觀看時長及流量來源可能會缺失。
為何指標可能缺失?
API 只返回 TikTok 分析所擁有的數據。帳戶擁有者須發佈至少一條影片,並在 TikTok 應用程式中開啟分析功能;分析功能開啟前的數據無法提供。部分指標的要求較高:覆蓋受眾及新增或流失追蹤者,只適用於具備 Advanced Access 或認證商業帳戶的帳戶;追蹤者分佈則須達到 100 人或以上。
為何這些數字可能與 TikTok 應用程式不同?
原因在於計算範圍。video_views 同時計算自然及付費觀看;shares 則計算在 TikTok 以外的分享,以及在應用程式內傳送給朋友的分享,因此可能高於 TikTok 網站上顯示的分享數目。某日的讚好數字亦不會扣除其後撤回的讚好。
easyCoexistence 如何讀取這些數據?
使用 get_social_insights。查詢帳戶時,請提供 followers_count、video_views 及 likes 等指標,並附上 start_date 與 end_date,即可取得 TikTok 的每日數據列。查詢單一影片時,將其 item_id 作為 object_id 傳入,即會返回觀看、讚好、留言及分享,搜尋範圍為帳戶最近 20 條影片;如需查詢較舊的影片,則由你自己的程式碼使用 get_social_credentials 提供的權杖,透過 filters.video_ids 呼叫 business/video/list/。
常見錯誤
- 將昨日數字視為最終數字。每日指標可能延遲 24 至 48 小時,近期日子的數據可能仍在更新。
- 要求超過 60 天的帳戶指標。回溯期到此為止,如需更長的歷史記錄,請自行儲存數字。
- 以 object_id 查找舊影片。get_social_insights 只搜尋最近 20 條;較舊的貼文請由你自己的程式碼,使用 get_social_credentials 提供的權杖,以 video_ids 篩選。
- 將 API 的分享數與網站數字比較。API 亦會計算在 TikTok 內傳送給朋友的分享,因此數字會較高。
至於其他 TikTok 數據欄位,get_social_credentials 會向您自己的程式碼提供帳戶的權杖。每個連接每月 US$ 9 至 US$ 0.75,連接越多越便宜,首 3 天免費。
常見問題
TikTok API 能顯示帳戶流失了多少追蹤者嗎?
可以,以 daily_lost_followers 顯示,並與 daily_new_followers 並列,適用於具備 Advanced Access 或認證商業帳戶的帳戶。
TikTok 帳戶數據最多可追溯多久?
60 天。若不指定日期,API 會以 UTC 計算,返回請求日前一天為止的 7 天數據。
TikTok 影片的數據何時停止更新?
影片發佈後 365 天。在此之前,其累計數字會持續更新,通常延遲 24 至 48 小時。
TikTok 影片觀看次數是否包括付費觀看?
是。TikTok 返回的 video_views 同時涵蓋自然及付費活動。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期