TikTok API 可以搜尋影片、主題標籤或趨勢嗎?
是的,TikTok API 能搜尋影片、廣告和趨勢,各由獨立的 API 負責:Research API 按關鍵字、主題標籤、用戶名稱、地區或日期搜尋公開影片,供 TikTok 批准的研究人員使用。Commercial Content API 按關鍵字或廣告主名稱搜尋廣告。API for Business 返回熱門主題標籤、其熱門影片及熱門搜尋關鍵字。Display API 則讀取獲授權用戶自己的個人檔案及影片。
easyCoexistence 透過 TikTok 的 API for Business 連接 TikTok 帳戶,讓 Claude、ChatGPT 或您自己的平台能列出該帳戶的貼文及留言、讀取其洞察數據,而 get_social_credentials 會為您自己的程式碼提供 business/ 端點(例如主題標籤建議)所需的權杖,並且每個連接全天候受到監察。
Research API 每日允許的請求數,最多 100,000 筆記錄,配額於 12 AM UTC 重設。
單次 Research API 影片查詢中,start_date 與 end_date 之間的最長跨度,每次請求最多返回 100 條影片。
熱門主題標籤 /discovery/trending_list/ 按國家及類別排名,涵蓋過去 1、7、30 或 120 天。
熱門搜尋關鍵字 /discovery/trending/search/ 供擁有 Advanced Access 或 Verified Business Account 的帳戶返回。
Commercial Content API 可接受的最長 search_term,預設以完整片語匹配,亦可設為模糊片語匹配。
哪些 TikTok API 可以搜尋?
有數個,分佈於兩個開發者入口網站,各自面向不同類型的開發者。developers.tiktok.com 承載 Research API、Commercial Content API 及 Display API;business-api.tiktok.com 承載 API for Business,其 Discovery、Accounts 及 Mentions 端點涵蓋趨勢及商業帳戶自身的內容:
Research API 如何搜尋影片?
使用 POST https://open.tiktokapis.com/v2/research/video/query/,並搭配持有 research.data.basic 範圍的客戶端存取權杖。查詢物件可組合 and、or 及 not 條件,每個條件都是針對欄位(例如 keyword、hashtag_name、username、region_code、create_date 或 video_length)的運算,例如 EQ 或 IN。start_date 與 end_date 以 YYYYMMDD 格式填寫,相隔最多 30 天,而 max_count 每次請求最多返回 100 條影片:
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
-H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"and": [
{ "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
{ "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
],
"not": [
{ "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
]
},
"max_count": 100,
"start_date": "20261001",
"end_date": "20261030"
}'Research API 返回什麼資料,時效如何?
fields 中列明的公開影片欄位,例如 id、video_description、create_time、region_code、view_count、like_count、comment_count、share_count、hashtag_names 及 username。TikTok 的常見問答指出,觀看次數及追蹤者人數等統計數據最多需要 10 天更新,而新影片最多需時 48 小時才會出現在搜尋結果中。每日配額為 1,000 次請求,跨所有研究 API 最多 100,000 筆記錄,於 12 AM UTC 重設。
哪些人可以使用 Research API?
研究計劃獲 TikTok 批准的研究人員;單是開發者帳戶並不能獲得存取權限。TikTok 列明的合資格對象包括美國、EEA、英國、加拿大或瑞士的學術機構,歐盟的非牟利或獨立研究機構,以及在巴西研究網上青少年安全的學術或非牟利機構。申請人須獨立於商業利益,並需具備明確的研究方案、披露資金來源,以及通過倫理審查,TikTok 一般會於 4 週內回覆。若問及創作者、廣告主及商業用戶是否符合資格,TikTok 的常見問答答案為否。
如何使用 Commercial Content API 搜尋廣告?
使用 POST https://open.tiktokapis.com/v2/research/adlib/ad/query/,並搭配 research.adlib.basic 範圍。search_term 最多接受 50 個字元,預設以 exact_phrase 匹配,亦可設為 fuzzy_phrase,即以任何次序找出其中任何或全部字詞;篩選條件可按發布日期及目標國家縮窄結果,每次呼叫最多返回 10 則廣告。TikTok 的產品頁面表示,資料由歐盟的廣告開始提供,並會保留至廣告最後一次展示後一年。任何國家的公眾及研究人員均可透過網上表格申請,TikTok 預計於 2 個工作天內回覆。
API for Business 返回哪些趨勢?
趨勢由其 Discovery 端點返回,端點按所用權杖而有不同。/discovery/trending_list/ 按國家(預設為美國)及行業類別,在過去 1、7、30 或 120 天內,為最多 200 個熱門主題標籤排名,並列出每個主題標籤的排名、觀看次數及貼文數目;/discovery/video_list/ 則為其中最多 10 個主題標籤返回前 20 條熱門影片。兩者均需要 advertiser_id 及廣告主的存取權杖。另外兩個端點需要 TikTok 帳戶的權杖,並具備 discovery.search.words 範圍,供擁有 Advanced Access 或 Verified Business Account 的帳戶使用:
- /discovery/trending/search/:TikTok 上的 20 個熱門搜尋關鍵字;若設
is_personalized,則為該帳戶度身定制。 - /discovery/trending/search/keyword/:針對最多 255 個字元的查詢(例如產品或品牌),推薦 20 個搜尋關鍵字。
TikTok 帳戶本身的 API 可以搜尋什麼?
可搜尋供其說明文字使用的主題標籤,以及載有其品牌主題標籤的貼文。GET /business/hashtag/suggestion/ 接受一個關鍵字及可選填的語言,並返回 10 個主題標籤,先按完全匹配排序,再按貼文數目排序,每個主題標籤附有其 post_count。Mentions 端點 /business/mention/hashtag/video/list/ 會返回過去 90 天內最多 1,000 則公開貼文,這些貼文使用商業帳戶已啟用的其中一個品牌主題標籤,最多返回 50 則,並可按時間、讚好數、留言數或分享數排序。此端點需要 biz.brand.insights 範圍,以及擁有 Advanced Access 或 Verified Business Account 的帳戶。
Display API 可以搜尋嗎?
不可以。它會讀取授權該應用程式的用戶:/v2/user/info/ 返回該用戶的個人檔案,/v2/video/list/ 返回其公開影片(最新的排在前面,每頁最多 20 條),而 /v2/video/query/ 則按 ID 返回指定影片,所需範圍為 user.info.basic 及 video.list。其任何端點都不接受關鍵字或主題標籤。
easyCoexistence 可以在 TikTok 上搜尋什麼?
可搜尋的範圍,是已連接帳戶自身 API 所能提供的內容。list_social_posts 列出該帳戶的近期貼文,list_social_comments 列出某則貼文的留言,而你自己的程式碼可憑 get_social_credentials 提供的權杖呼叫 business/ 下的 API for Business 路徑,包括主題標籤建議。/discovery/ 路徑需要廣告主的權杖,因此帳戶的權杖無法存取這些路徑;Research API 及 Commercial Content API 則是 developers.tiktok.com 上獨立的產品,各自需要另行申請。
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>常見錯誤
- 為追蹤品牌而申請 Research API。TikTok 的常見問答對創作者、廣告主及商業用戶的答案是否定的,只批准非商業研究計劃。
- 在單次 Research API 呼叫中查詢較長時段。end_date 最多只能比 start_date 晚 30 天,因此應把較長時段拆分為多個時間窗口。
- 把主題標籤建議當作趨勢來看。/business/hashtag/suggestion/ 按完全匹配及貼文數目排序,而 /discovery/trending_list/ 則是在所選時段內按熱度排名。
- 為個人帳戶呼叫熱門搜尋端點。這些端點只回應擁有 Advanced Access 或 Verified Business Account 的帳戶,且權杖須具備 discovery.search.words 範圍。
每個連接每月 US$ 9 至 US$ 0.75,連接越多越便宜,首 3 天免費。
常見問題
可以透過 API 按關鍵字搜尋 TikTok 影片嗎?
可以,待 TikTok 批准您的研究計劃後,Research API 的影片查詢可按 keyword 及 hashtag_name 條件搜尋公開影片,每次請求最多 100 條。
有沒有用於熱門主題標籤的 TikTok API?
有。API for Business 的 /discovery/trending_list/ 可按國家及類別排名最多 200 個熱門主題標籤,並附上各自的觀看次數及貼文數目,使用廣告主的權杖。
有沒有用於熱門影片的 TikTok API?
有。API for Business 的 /discovery/video_list/ 可為最多 10 個熱門主題標籤返回前 20 條熱門影片,需要 advertiser_id 及廣告主的存取權杖。
TikTok API 可以找出提及我的帳戶的留言嗎?
可以,但需擁有 Advanced Access 或 Verified Business Account:Mentions API 的 /business/mention/comment/list/ 最多返回 1,000 條提及該帳戶的留言或回覆,並需要 biz.brand.insights 及 comment.list 範圍。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期