TikTok Business Organic Videos API返回成功但无数据问题求助
TikTok商家原生视频列表接口无数据返回排查方案
调用TikTok商家账号原生视频数据接口时,参数配置无误,但仅返回成功状态(code=0),响应仅包含cursor和has_more字段,无实际视频数据,可从以下几点排查:
起始时间戳(cursor)设置错误
接口的cursor参数基于视频创建时间戳,若传入的cursor晚于账号内所有视频的发布时间,会返回空列表。示例中cursor=1764932610000对应2025年5月左右,若账号无该时间后发布的视频,自然无数据返回。
解决:将cursor设为0或远早于账号第一条视频发布时间的时间戳,重新发起请求。权限范围不足
即使access_token有效,也可能未获取目标商家账号的视频数据读取权限,比如授权时未勾选business.video.list权限,或token的权限范围不覆盖目标账号。
解决:检查授权流程中申请的权限列表,确保包含视频数据读取权限;验证access_token的有效权限范围。fields参数编码/格式错误
手动URL编码的fields数组可能存在格式问题(如引号不配对、分隔符错误),导致接口无法解析需要返回的字段。
解决:使用未编码的JSON数组格式指定fields,让请求库自动处理URL编码,避免手动编码出错。目标账号无符合条件的视频
若商家账号下无公开的原生视频(如视频为私密状态、已删除、审核中),接口会返回空数据。
解决:登录TikTok商家后台,确认账号下存在已发布的公开原生视频。
修正后的示例请求
curl --location --globoff 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/?business_id=business_id&cursor=0&fields=["audience_countries","impression_sources","average_time_watched","caption","comments","create_time","embed_url","full_video_watched_rate","item_id","likes","reach","shares","share_url","thumbnail_url","total_time_watched","video_duration","video_views"]' \ --header 'Access-Token: access_token'
内容的提问来源于stack exchange,提问作者DSK




