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 作用域的客户端访问令牌。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 个视频:
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 上独立的产品,各自需要单独申请。
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 批准了您的研究项目:其视频查询接受对公开视频的 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 监控
验证时间