你准备整理自己 TikTok 账号里的几段活动记录，列表里能看到封面和标题，但后续交给剪辑同事时，需要知道每条材料到底取到了什么。先把原帖、详情查询和文件状态分开，能避免交付一份看似齐全却没有文件的清单。

作者标识先核对再取作品

用户作品接口提供 sec_user_id、unique_id 等参数，按文档准备正确的账号条件，不把显示名称当成所有标识通用。保存地区、排序与 max_cursor 分页情况，先确认几条返回确实来自目标账号。某条未在本轮出现不代表不存在，记录当前覆盖范围即可。

用作品标识查询单条详情

对选定内容使用 aweme_id 获取作品数据，检查实际返回的信息，并与原链接对应。当前契约概括为作品数据，不能假定每次都有同样的媒体结构，更不能保证某个地址永久有效。若只取得封面或描述，就如实写出，不把它们当作视频文件的替代品。

媒体登记表保留处理证据

表格可以包含原帖来源、作品 ID、活动环节、查询时间、取得的信息类型和文件处理状态。这些都是你设计的管理字段。对每一项说明是已查看详情、已有可用信息还是尚未处理；AI 能整理说明，不能替你补一个看起来像真的下载链接或本地路径。

后续保存需要单独执行与检查

这组绑定查询不是一键下载服务，也不会自动去水印、合并媒体或制作剪辑包。若之后采用可用的保存流程，要实际检查输出与目标作品是否一致，再把状态改为完成。地址失效或内容取不到时记录原因，不无限重复请求试图证明成功。最终交付的是清楚说明已有材料与缺口的目录，剪辑同事能据此决定下一步，而不会误把资料索引当作完整素材交接。

这篇用到的接口

完整地址与参数

GET https://api.trmesh.com/openapi/api/v1/tiktok/app/v3/fetch_user_post_videos

参数 类型 必填 含义
sec_user_id string 否 用户sec_user_id
unique_id string 否 用户unique_id
max_cursor integer 否 最大游标
count integer 否 每页数量
sort_type integer 否 排序类型
region string 否 国家地区

可以复制的 Python 请求

安装 requests 并在环境变量中设置 TRMESH_API_TOKEN。把示例用户名或作品 ID 换成你要查询的对象。

import os
import requests

# 使用自己的 TRMesh 开发者密钥；不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/tiktok/app/v3/fetch_user_post_videos"
params = {
    "sec_user_id": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
    "region": "US"
}
response = requests.get(
    url, params=params, timeout=30,
    headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload)  # 先核对真实响应，再提取业务字段

对应接口文档 · 返回免费查询工具

调用接口会使用你的 TRMesh 账号额度，运行前请确认接口价格。