TikTok 用户、视频与音乐数据 API

通过必填的路径参数 challenge_id 查询 TikTok 话题（标签）信息。话题 ID 必须按字符串传入，文档默认值为 229207。本接口面向已知话题 ID，不接受话题名称，也不用于获取该话题的视频列表。目前没有可核验的实际响应，也未提供响应示例或字段结构说明，因此返回字段及可用统计指标尚未确认。请勿直接套用按话题名称查询接口中的 data.ch_info 字段；应先检查实际响应，再确定元数据字段映射或计数计算方式。本次查询不能用于确认历史趋势，也不代表已收集该话题下的全部视频。

请求 TikTok 话题（标签）关联的视频列表。必填路径参数 challenge_id 应以字符串传入，文档默认值为 229207。可选查询参数 max_cursor 也为字符串，但没有已说明的默认值或示例。首次请求应省略该参数，不要自行假定起始游标。目前没有可核验的实际响应，也未提供响应示例或字段结构说明，因此视频条目字段、列表所在字段、下一页游标字段及列表结束标记均未确认。继续翻页前，请先核实实际响应中的游标如何对应 max_cursor。返回的视频应作为有限样本使用，不代表完整历史导出、全部话题参与者名单，也不保证固定排序。

通过必填的字符串路径参数 challenge_name 查询话题（标签）信息。虽然操作标识中含有 keyword，但本接口是按名称查询，不是返回多个匹配标签的自由文本搜索。文档示例和默认值均为 fyp。已有一次针对 fyp 的成功实测：HTTP 状态码为 200，响应包含 status=ok 和 data.status_code=0。观测到的 data.ch_info 对象包含返回的标签名称 cha_name、话题标识 cid、用量相关计数 user_count 和浏览计数 view_count。该次响应中 cha_name=fyp、cid=229207，user_count 和 view_count 均为非零值，另有分享信息，但其嵌套字段尚未明确。这些字段只在一次实测中得到观察，不保证所有名称都返回相同结构；目前也没有单独提供响应示例或字段结构说明。如需衔接按话题 ID 查询资料或获取视频列表的流程，请同时保存提交的名称与返回的 cid。计数应记录为带获取时间的报告值快照，不能解释为独立人数、去重触达量、增长率或历史趋势。

通过必填路径参数 challenge_name 获取某个 TikTok 挑战话题（即标签）对应的视频列表，文档示例为 fyp。此接口按话题名称查询，并非通用的视频关键词搜索。可选查询参数 max_cursor 用于分页，首次请求应省略；游标的具体含义及续页时应使用的响应字段尚未验证。接口文档说明返回话题视频列表，但目前没有可用的成功响应样例或字段结构，因此视频字段、响应外层结构和分页输出均未确认。请将结果视为该话题的视频样本，而非使用该标签的全部视频导出。

通过必填路径参数 video_id 获取 TikTok 视频评论，参数应为视频 ID 字符串，而非完整视频链接。可选查询参数 max_cursor 为分页字符串，首次请求请省略。已观察到的成功响应包含 status=ok，以及带有 status_code、comments、cursor、has_more 和 total 字段的 data 对象。一次有数据的测试返回了 50 条评论，cursor=50、has_more=1、total=6574；这些只是样本结果，并非固定的每页条数或保证的评论总量。已观察到的评论字段包括 aweme_id（所属视频 ID）、cid（评论 ID）、text、create_time（数值形式的创建时间）、digg_count（点赞数）、reply_comment_total（回复数）、reply_id、reply_to_reply_id 和 user。user 中的身份字段包括 uid、unique_id、nickname 和 sec_uid。一次负向对照测试返回 HTTP 200，且 data.status_code=0、comments=null、cursor=0、has_more=0、total=0。应将其作为空样本处理，不能据此断定视频不存在或没有公开讨论。has_more 非零表示可继续获取，但如何将响应中的 cursor 用作请求参数 max_cursor 尚未验证。此接口未记载可指定每页条数的参数，也未提供单独获取回复的操作；出现回复数量不代表已包含回复正文。

通过必填路径参数 music_id 查询一条 TikTok 音乐或音频记录的元数据。请传入音频 ID，而非视频 ID、曲名或完整链接，文档示例为 7443916074024913686。一次使用其他音频 ID 的成功测试返回 status=ok，data 中包含 status_code=0、msg=success 和 music_info。已观察到的 music_info 字段包括 id_str（音频标识）、title、author、album、owner_handle、owner_id、owner_nickname、duration（秒）、user_count（报告的使用次数）、play_url，以及 cover_large、cover_medium、cover_thumb。play_url 对象中已观察到 uri、url_list、width、height、data_size 和 file_hash。采样的原创音频记录中 duration=9、user_count=30；这些只是观察值，不是固定数值，也不保证对应文档中的示例 ID。元数据和播放链接无法证明音频对应某首商业发行歌曲，也不代表获得下载许可或复用权利。请将 user_count 视为返回的音频使用量指标，而非视频播放量、独立听众数或完整的使用情况统计。音频链接的可用性和有效期均无保证；此接口不返回使用该音频的视频分页列表。

通过必填路径参数 music_id，获取与指定 TikTok 声音关联的视频列表。请填写声音的音乐 ID，而不是显示名称；文档示例为 7443916074024913686。可选查询参数 max_cursor 为字符串，用于尝试分页。首次请求不传该参数，继续翻页前应先确认实际响应中的游标及续页方式。接口说明仅明确这是与音乐关联的视频列表，未提供响应字段结构，也没有该接口的实测响应或响应示例。因此，视频 ID、创作者资料、互动数量、响应中的游标字段和分页结束条件均未得到验证。请将结果作为该声音相关视频的可用样本，而非使用该声音的全部视频，或经核实的声音使用总量。

在路径中填写必填字符串 keyword，搜索 TikTok 挑战，也就是话题标签。这是按关键词发现候选话题的接口，并非精确名称查询，也不会直接获取某个挑战的视频列表。可选查询参数 max_cursor 为字符串，用于尝试分页。首次搜索不传该参数，后续应根据搜索响应确认续页方式，不要直接套用视频列表的游标规则。接口说明仅明确结果属于挑战搜索，未提供响应字段结构，也没有该接口的实测响应或响应示例。因此，候选名称、挑战 ID、排序、数量、响应外层结构及续页字段均未得到验证。选择要监测的挑战前，请先检查实际匹配结果的相关性，并区分含义不明确的候选项。

获取 TikTok 热门视频流，接口说明将其描述为主屏幕轮播视频流。请求无需填写用户名、视频 ID 或关键词，唯一记录的输入是可选字符串查询参数 custom_cursor；首次获取样本时不传即可。一次不带参数的实测请求返回 HTTP 200，响应中观察到 status=ok、data.custom_cursor，以及嵌套的 data.list 对象。data.list 包含 status_code=0、has_more=1 和有 10 条视频的 aweme_list 数组。该样本还包含创作者信息与互动数量，但此处尚未确认各项字段名称及其完整性。请注意层级：视频和 has_more 位于 data.list 内，custom_cursor 则直接位于 data 下。可将返回的游标作为续页输入的候选值，并检查后续响应；此次实测未验证完整分页流程。样本视频的创建日期介于 2026-08-30 至 2026-10-21，包含实测当天，因此应将每条视频的 create_time 与本地采集时间对比，不要将所有条目都视为新发布内容。这些观察仅对应一次响应，不代表固定每页条数、通用热度排名、账号个性化推荐流或保证完整的导出结果，也没有其他响应示例提供更多已验证字段。

获取指定地区的 TikTok 热门视频信息流。必填参数 region 用于选择地区，文档中的默认值和示例均为 US。可选查询参数 custom_cursor 为字符串，但文档未提供示例值，也未说明其翻页行为。首次请求请留空；使用前应先验证该接口接受的游标值及其实际作用。 此接口暂无响应示例或已观测的响应。字段名称、信息流外层结构、视频标识、排序方式和后续分页字段均未核实，不能直接套用全局热门信息流的响应结构。region 只表示本次请求选择的信息流地区，并不能证明创作者或观众的居住地。除 US 示例外，文档未列出其他受支持的地区值。

通过 GET /user/id/{user_id} 查询已知用户 ID 对应的 TikTok 个人资料。必填路径参数 user_id 为字符串，内容应是数字形式的 TikTok 用户标识，而不是用户名或个人主页链接。文档中的默认值和示例均为 127905465618821121。请将完整 ID 作为文本保留，不要转换为浮点数，以免数字精度丢失。此接口没有文档列明的分页或信息流参数。 此 ID 查询接口暂无响应示例或已观测的响应。具体资料字段、嵌套对象、统计值以及用户不存在时的响应结构均未核实，不能假定其与按用户名查询的接口返回相同字段。将资料写入创作者数据库之前，请先验证实际响应，仅使用响应中确实提供的属性。

通过 GET /user/id/{user_id}/feed 获取 TikTok 用户的媒体信息流。必填参数 user_id 应以字符串形式传入数字用户标识，文档中的默认值和示例均为 127905465618821121，请完整保留每一位数字。可选查询参数 max_cursor 和 min_cursor 也都是字符串。文档未提供这两个参数的示例值、默认值、翻页方向或日期含义。首次请求时请均留空；设计采集进度保存机制前，应分别验证各自的行为，不能将它们视为页码、已确认的日期筛选条件或可互换的值。 此 ID 视频信息流接口暂无响应示例或已观测的响应。媒体列表容器、视频标识字段、排序方式、条目数量、后续分页字段和结束标志均未核实，不能从其他信息流接口推定其响应结构。归档条目或轮询新内容之前，请先确认返回的标识和分页行为。取得的信息流样本不保证覆盖该账号的完整历史。

使用必填路径参数 sec_user_id 查询 TikTok 用户资料。请原样传入已有的辅助用户标识，不要用 @用户名或其他接口使用的数字形式 user_id 替代。此查询适合解析导入记录中的辅助标识引用，也可在缺少当前用户名时刷新关联的用户资料。现有文档仅说明返回用户资料，未列出具体响应字段；也没有可供核对的实际调用结果或响应示例，因此响应结构、资料字段名称以及是否返回其他标识均尚未确认。建立字段映射前，请先检查实际响应；现有信息不能确认是否提供用户统计、图片或私密账号数据。

同时提供两个必填路径参数 sec_user_id 和 user_id，查询 TikTok 用户资料。请使用可信记录中属于目标账号的标识组合：辅助标识须保持原样，数字形式的 user_id 也须作为字符串保留。此接口适合处理已经存有这两个标识的导入记录。现有文档只说明返回用户资料，没有列出具体响应字段，也没有可供核对的实际调用结果或响应示例，因此响应结构、返回哪些标识以及标识不匹配时的处理方式均尚未确认。核对结果时，只比较响应实际包含的标识；此查询不能证明账号所有权，不是身份核验服务，也不保证能识别标识不匹配的情况。

通过必填路径参数 user_id 获取指定账号的粉丝列表。请将数字形式的账号标识作为字符串传入，不要使用 @用户名或 sec_user_id 替代。可选查询参数 min_time 同样为字符串，但现有文档没有定义其格式、单位、筛选规则或续取方式。未经验证适用值时，请省略该参数，不要假设它接受 Unix 时间戳或充当分页游标。文档只说明响应为粉丝列表，没有列出列表字段名、粉丝记录字段、数量、游标或采集完成标记；也没有可供核对的实际调用结果或响应示例。请将返回数据视为本次观察到的样本，而非保证完整的粉丝导出；不同样本之间的差异不能证明新增关注或取消关注，也不能据此确认受众人口属性或联系方式。

通过必填的字符串路径参数 user_id，查询某个 TikTok 用户关注了哪些账号。此接口查询的是该用户主动关注的账号，不是关注该用户的粉丝。文档中的用户 ID 示例为 127905465618821121。可选查询参数 min_time 同样为字符串，但其可接受的格式、时间单位及翻页行为尚未验证；除非已有在此接口上确认可用的值，否则请省略。文档将结果描述为已关注用户列表，但未提供此接口的响应示例或成功请求记录，因此响应外层结构、账号字段名、排序、每页条数及分页规则均未确认。接入字段或编写翻页逻辑前，请先检查实际返回结构。应将返回的关系视为采集到的样本，而非保证完整的关注名单、关注变化历史、认可背书或私下关系的证据。

通过必填的字符串路径参数 username 查询 TikTok 账号资料，例如 khaby.lame。此接口用于查询已知用户名，不是按关键词发现用户。已观察到的成功请求返回 HTTP 200，包含 status=ok、data.status_code=0 和 data.user 对象。观察到的用户字段包括 unique_id（用户名）、uid（账号标识）、nickname（显示名称）、follower_count（返回的粉丝数）和 aweme_count（返回的作品数）。khaby.lame 样本中的 unique_id=khaby.lame、uid=127905465618821121；其中的计数仅反映采集时点，不代表当前数值或历史总量。使用不存在的测试用户名发起请求时，返回 HTTP 404，包含 status=error、error=not found 和 error_description=resource not found。应将这一已观察到的未找到响应视为查询结果，而非服务故障，同时单独处理其他失败情况。上述字段来自已有请求观察记录，没有独立响应示例可用于确认更多字段。保存账号资料时请记录采集时间，将计数变化解释为不同快照之间的差异，而非历史分析数据流。

通过必填的字符串路径参数 username 获取 TikTok 创作者的作品列表，例如 khaby.lame。可选查询参数 max_cursor 和 min_cursor 均为字符串；首次请求请同时省略。已观察到的成功请求返回 HTTP 200、status=ok，data.aweme_list 中包含 10 条视频，并返回 has_more=1 以及 min_cursor、max_cursor 分页字段。该样本的视频记录包含视频标识、作者信息、创建时间戳、互动统计和可播放的媒体链接。样本中首条 aweme_id 为 7697307919943060767，作者是 khaby.lame，创建日期为 2026-10-16，采集时返回的播放量为 3363153。这些只是样本观察值，并非固定返回内容，也不保证每页都含有 10 条记录。已有研究也指出作品描述可用于内容审阅，但现有证据尚未确定对应的准确响应字段名；也没有独立响应示例可用于确认其他嵌套字段名。可将返回的游标字段暂存为后续翻页的候选位置，并保留其字符串值，但正确的游标组合、翻页方向及连续多页行为尚未验证。采集时请按视频 ID 去重，并在游标位置重复时停止。此接口没有 count 参数。不要根据已观察到的一页结果推断其按时间排序、覆盖完整发帖历史、提供创作者私有分析数据或保证媒体链接永久可用。

通过路径参数 video_id 查询一条 TikTok 视频的详情。请将纯数字视频 ID 作为字符串传入，不要填写用户名或完整的视频链接。文档中的默认值为 7468030505628224790，该值仅作输入示例，不代表对应视频始终可用。此查询未记载分页参数或请求体输入。 已观察到的成功结果中，status 为 ok，data.status_code 为 0，data.aweme_detail 对象包含 aweme_id、author.unique_id 和 create_time。该次结果的视频 aweme_id 为 7697307919943060767，author.unique_id 为 khaby.lame，create_time 为 1792169181；同时还观察到了视频描述、9500 毫秒的视频时长、音乐信息和互动统计。这些信息仅说明一次成功查询的情况，不保证每个视频 ID 都会返回同样的内容。 现有资料未提供完整响应示例，也未列明描述、时长、音乐和互动统计的嵌套字段，无法确定音乐 ID 的具体属性名，或保证返回可播放的媒体链接。提取这些信息或衔接音乐查询前，请先核对实际返回对象。视频 ID 应始终按字符串处理，以免丢失数字精度。互动数据仅代表查询时的快照，建议单独记录 fetched_at，不要将其与视频创建时间 create_time 混用。获取视频元数据不授予下载或内容再利用的权利，也不提供私密账号访问能力，不能替代创作者官方数据分析。