登录开始免费试用
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 作用域的客户端访问令牌。query 对象可组合 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 次请求,Research API 合计最多 100,000 条记录,于 12 AM UTC 重置。

谁可以使用 Research API?

TikTok 批准其研究项目的研究人员;仅有开发者账户并不能获得访问权限。TikTok 列出的对象包括:美国、欧洲经济区、英国、加拿大或瑞士的学术机构,欧盟的非营利或独立研究机构,以及在巴西研究网络青少年安全的学术或非营利组织。申请人的工作须独立于商业利益,并具备明确的研究方案、公开的资金来源和伦理审查,TikTok 通常在 4 周内答复。被问及创作者、广告主和商业用户是否符合资格时,其常见问题解答的答案是否定的。

如何使用 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 以及广告主的访问令牌。另外两个端点需使用带 discovery.search.words 作用域的 TikTok 账户令牌,适用于拥有 Advanced Access 或 Verified Business Account 的账户:

  • /discovery/trending/search/:返回 20 个在 TikTok 上流行的搜索关键词,或通过 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 批准了您的研究项目:其视频查询接受对公开视频的 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 监控

验证时间