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

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/ 端點(例如主題標籤建議)所需的權杖,並且每個連接全天候受到監察。

1,000 a day

Research API 每日允許的請求數,最多 100,000 筆記錄,配額於 12 AM UTC 重設。

30 days

單次 Research API 影片查詢中,start_date 與 end_date 之間的最長跨度,每次請求最多返回 100 條影片。

Top 200

熱門主題標籤 /discovery/trending_list/ 按國家及類別排名,涵蓋過去 1、7、30 或 120 天。

20

熱門搜尋關鍵字 /discovery/trending/search/ 供擁有 Advanced Access 或 Verified Business Account 的帳戶返回。

50 characters

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 APIPublic videos by keyword, hashtag, username, region or date; approved researchers
Commercial Content APIAds by keyword or advertiser name, starting with ads data from the EU
Discovery endpointsPopular hashtags, their trending videos, and trending search keywords
Mentions endpointsUp to 1,000 recent public posts carrying the business's brand hashtags
Hashtag suggestion10 hashtags for a keyword, for the authorized account's captions
Display APINo search: an authorized user's profile and public videos

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 條影片:

A Research API video query, after TikTok's own example
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 上獨立的產品,各自需要另行申請。

Hashtag suggestions from your own code
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 範圍。
使用 EasyCoexistence 完成這項設定

每個連接每月 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 監察

驗證日期