TikTok 视频详情 & 列表 API 接口技术文档（带全套 JSON 样例・核心章节）

知名用户180079054738小时前未分类6

一、接口整体说明

TikTok 视频接口分两类：①用户作品列表接口（批量拉取多视频）、②单条视频详情接口（指定 aweme_id 查单品），通用cursor游标分页，不使用 page 页码；鉴权统一 Header：Authorization: Bearer ApiKey，单页上限 20~35 条，QPS 官方限流 3 次 /s。

1. 接口地址与入参

（1）用户作品列表（批量列表）

请求：GET /api/v1/tiktok/user/post/list

json

// 请求入参JSON{

    "sec_user_id": "MS4wLjABAAAA8fKxxxxxxx",
    "max_cursor": "0",
    "limit": 20,
    "region": "US"}

表格

参数	必填	释义
sec_user_id	是	创作者唯一安全 ID，主页链接提取
max_cursor	否	分页游标，首次 = 0，下一页用上轮返回 max_cursor
limit	否	单页条数，1~35
region	否	地区码 US/GB/JP 等

（2）单视频详情接口

请求：GET /api/v1/tiktok/video/detail

json

{

    "aweme_id":"7528963259874125698"}

二、接口原生返回 JSON（脱敏真实原版・列表 + 单详情）

1. 用户作品列表原始返回 JSON

原生嵌套层级深：作者信息、视频资源、音乐、互动统计多层内嵌，含大量冗余扩展字段，无法直接入库。

json

{

    "code":0,
    "msg":"success",
    "request_id":"tk_req_95632187",
    "data":{
        "has_more":true,
        "max_cursor":"1750236985000",
        "min_cursor":"0",
        "aweme_list":[
            {
                "aweme_id":"7528963259874125698",
                "desc":"Summer daily outfit✨ #fashion #ootd #summerlook",
                "create_time":1750212365,
                "is_private":false,
                "author":{
                    "uid":"6952369874521",
                    "unique_id":"lily_fashion_us",
                    "nickname":"Lily Fashion",
                    "avatar":"https://p3.tiktokcdn.com/tos-maliva-avt/xxx.jpg",
                    "signature":"Daily fashion sharing | US blogger",
                    "is_verified":true
                },
                "video":{
                    "duration":12800,
                    "width":1080,
                    "height":1920,
                    "cover":{
                        "url_list":["https://p3.tiktokcdn.com/tos-maliva-video/cover1.jpg"]
                    },
                    "play_addr":{
                        "url_list":["https://v16-web.tiktok.com/xxx.mp4"]
                    }
                },
                "music":{
                    "music_id":"7489562135987",
                    "title":"Sunny Day Vibe",
                    "author":"DJ Mark",
                    "cover":"https://p3.tiktokcdn.com/tos-maliva-music/msc.jpg"
                },
                "statistics":{
                    "digg_count":12589,
                    "comment_count":892,
                    "share_count":326,
                    "collect_count":1563,
                    "play_count":215689
                },
                "text_extra":[
                    {"hashtag_name":"fashion","hashtag_id":"523698"},
                    {"hashtag_name":"ootd","hashtag_id":"256987"}
                ]
            },
            {
                "aweme_id":"7528959874125369852",
                "desc":"Affordable casual clothes haul🛒 #clothes #shopping",
                "create_time":1750198652,
                "is_private":false,
                "author":{
                    "uid":"6952369874521",
                    "unique_id":"lily_fashion_us",
                    "nickname":"Lily Fashion",
                    "avatar":"https://p3.tiktokcdn.com/tos-maliva-avt/xxx.jpg",
                    "signature":"Daily fashion sharing | US blogger",
                    "is_verified":true
                },
                "video":{
                    "duration":9600,
                    "width":1080,
                    "height":1920,
                    "cover":{"url_list":["https://p3.tiktokcdn.com/tos-maliva-video/cover2.jpg"]},
                    "play_addr":{"url_list":["https://v16-web.tiktok.com/xxx2.mp4"]}
                },
                "music":{
                    "music_id":"7489561236954",
                    "title":"Shopping Mood",
                    "author":"Luna Band",
                    "cover":"https://p3.tiktokcdn.com/tos-maliva-music/msc2.jpg"
                },
                "statistics":{
                    "digg_count":9856,
                    "comment_count":632,
                    "share_count":215,
                    "collect_count":986,
                    "play_count":159632
                },
                "text_extra":[
                    {"hashtag_name":"clothes","hashtag_id":"326985"},
                    {"hashtag_name":"shopping","hashtag_id":"159874"}
                ]
            }
        ]
    }}

2. 单条视频详情原生 JSON（精简）

json

{

    "code":0,
    "msg":"success",
    "data":{
        "aweme_detail":{
            "aweme_id":"7528963259874125698",
            "desc":"Summer daily outfit✨ #fashion #ootd #summerlook",
            "create_time":1750212365,
            "author":{
                "unique_id":"lily_fashion_us",
                "nickname":"Lily Fashion",
                "is_verified":true
            },
            "statistics":{
                "digg_count":12589,
                "comment_count":892,
                "share_count":326,
                "collect_count":1563,
                "play_count":215689
            },
            "video":{
                "duration":12800,
                "cover":{"url_list":["https://p3.tiktokcdn.com/cover1.jpg"]},
                "play_addr":{"url_list":["https://v16-web.tiktok.com/xxx.mp4"]}
            },
            "music":{
                "title":"Sunny Day Vibe","author":"DJ Mark"
            }
        }
    }}

三、原生 JSON 现存痛点

时间是 Unix 时间戳，无法直接展示、按日期统计；
话题标签text_extra为数组嵌套，标签和 ID 混存，关键词提取繁琐；
视频封面、播放地址放在url_list数组内，多链接冗余，仅取首图即可；
作者信息深度内嵌，不利于创作者、视频分表存储；
空字段（无音乐 / 无话题）字段结构不一致，遍历易空指针异常；
分页游标分散在顶层 data，批量采集需单独存储max_cursor。

四、结构化解析后标准 JSON（业务落地模型，可直接入库 MySQL/ES）

扁平化字段、时间格式化、标签数组提取、资源精简，是竞品分析、爆款筛选、达人数据统计标准格式：

json

{

    "next_cursor":"1750236985000",
    "has_more":true,
    "video_list":[
        {
            "aweme_id":"7528963259874125698",
            "video_desc":"Summer daily outfit✨ #fashion #ootd #summerlook",
            "publish_ts":1750212365,
            "publish_time":"2025-03-19 14:06:05",
            "is_private":false,
            "author_info":{
                "uid":"6952369874521",
                "unique_id":"lily_fashion_us",
                "nickname":"Lily Fashion",
                "avatar":"https://p3.tiktokcdn.com/tos-maliva-avt/xxx.jpg",
                "signature":"Daily fashion sharing | US blogger",
                "is_verified":true
            },
            "video_resource":{
                "duration_ms":12800,
                "duration_sec":12.8,
                "width":1080,
                "height":1920,
                "cover_img":"https://p3.tiktokcdn.com/tos-maliva-video/cover1.jpg",
                "play_url":"https://v16-web.tiktok.com/xxx.mp4"
            },
            "music_info":{
                "music_id":"7489562135987",
                "music_name":"Sunny Day Vibe",
                "music_author":"DJ Mark",
                "music_cover":"https://p3.tiktokcdn.com/tos-maliva-music/msc.jpg"
            },
            "stats":{
                "play":215689,
                "like":12589,
                "comment":892,
                "share":326,
                "collect":1563
            },
            "hashtags":["fashion","ootd","summerlook"]
        },
        {
            "aweme_id":"7528959874125369852",
            "video_desc":"Affordable casual clothes haul🛒 #clothes #shopping",
            "publish_ts":1750198652,
            "publish_time":"2025-03-19 09:37:32",
            "is_private":false,
            "author_info":{
                "uid":"6952369874521",
                "unique_id":"lily_fashion_us",
                "nickname":"Lily Fashion",
                "avatar":"https://p3.tiktokcdn.com/tos-maliva-avt/xxx.jpg",
                "signature":"Daily fashion sharing | US blogger",
                "is_verified":true
            },
            "video_resource":{
                "duration_ms":9600,
                "duration_sec":9.6,
                "width":1080,
                "height":1920,
                "cover_img":"https://p3.tiktokcdn.com/tos-maliva-video/cover2.jpg",
                "play_url":"https://v16-web.tiktok.com/xxx2.mp4"
            },
            "music_info":{
                "music_id":"7489561236954",
                "music_name":"Shopping Mood",
                "music_author":"Luna Band",
                "music_cover":"https://p3.tiktokcdn.com/tos-maliva-music/msc2.jpg"
            },
            "stats":{
                "play":159632,
                "like":9856,
                "comment":632,
                "share":215,
                "collect":986
            },
            "hashtags":["clothes","shopping"]
        }
    ]}

五、异常返回 JSON（错误码参考，异常捕获必备）

json

// Token失效{

    "code":401,
    "msg":"ApiKey invalid or expired",
    "request_id":"tk_err_125698",
    "data":{}}// 接口限流{
    "code":429,
    "msg":"Request frequency limit, wait 15s",
    "data":{}}// 无效用户ID{
    "code":400,
    "msg":"sec_user_id not found",
    "data":{}}

六、核心解析实战要点

时间标准化：create_time时间戳转yyyy-MM-dd HH:mm:ss，新增秒数字段duration_sec便于筛选短视频；
话题标签提取：遍历text_extra数组，只提取hashtag_name生成纯标签数组；
资源地址精简：封面、播放链接只取url_list[0]首地址，剔除冗余备用 CDN 链接；
空值容错：无音乐时music_info设为空对象，无话题hashtags=[]，规避索引报错；
分页采集逻辑：has_more=true则带入max_cursor循环翻页，直到 false 结束全量抓取。

七、极简 Python 解析示例（配套实战代码）

python

运行

import timedef parse_tiktok_video(raw_json):
    res = {}
    resp = raw_json.get("data",{})
    res["next_cursor"] = resp.get("max_cursor","")
    res["has_more"] = resp.get("has_more",False)
    video_arr = []
    for item in resp.get("aweme_list",[]):
        video = {}
        video["aweme_id"] = item["aweme_id"]
        video["video_desc"] = item["desc"]
        ts = item["create_time"]
        video["publish_ts"] = ts
        video["publish_time"] = time.strftime("%Y-%m-%d %H:%M:%S",time.localtime(ts))
        video["is_private"] = item["is_private"]
        #作者信息
        au = item["author"]
        video["author_info"] = au        #视频资源
        vd = item["video"]
        video["video_resource"] = {
            "duration_ms":vd["duration"],
            "duration_sec":round(vd["duration"]/1000,1),
            "width":vd["width"],
            "height":vd["height"],
            "cover_img":vd["cover"]["url_list"][0],
            "play_url":vd["play_addr"]["url_list"][0]
        }
        #互动数据
        st = item["statistics"]
        video["stats"] = {
            "play":st["play_count"],
            "like":st["digg_count"],
            "comment":st["comment_count"],
            "share":st["share_count"],
            "collect":st["collect_count"]
        }
        #话题标签
        tags = [i["hashtag_name"] for i in item.get("text_extra",[])]
        video["hashtags"] = tags
        video_arr.append(video)
    res["video_list"] = video_arr    return res

八、落地业务场景

海外达人监控：批量抓取博主作品播放 / 点赞，筛选潜力达人；
爆款内容挖掘：按播放、互动率筛选高流量短视频，复盘爆款标签；
跨境选品分析：穿搭 / 好物类视频统计热门品类、关键词，辅助选品；
竞品账号跟踪：定时拉取竞品作品数据，监控上新与流量变化。

返回列表

上一篇：小红书笔记评论 API 接口深度解析（带全套 JSON 示例・技术实战版）

没有最新的文章了...

淘宝商品详情API的常见错误排查有哪些？

调用淘宝商品详情 API（如taobao.item.get）时，会遇到签名错误、权限不足、参数非法等各类问题，排查需遵循「先校验基础配置，再定位业务逻辑」的原则。以下是常见错误分类、现象、原因及解...

欢迎来到我的博客~

欢迎来到我的博客~...

多语言采集淘宝京东拍立淘按图搜索，API接口（json数据返回）

淘宝拍立淘API接口（JSON数据返回）接口核心功能技术基础：基于深度学习与计算机视觉技术，支持多模态特征提取（如ResNet-152卷积神经网络），可解析商品外观、形状、颜色等200+维度特征。搜索...

Python 实现速卖通（AliExpress）商品详情 API 数据准确性校验

前言简洁可直接使用，适配跨境电商商品同步、数据分析、铺货上货场景。一、校验核心要点返回 JSON 结构完整正常商品 ID（productId）有效标题不为空、长度合理价格合法（大于 0）主图链接有效库...

电商评论API深度解析：淘宝、京东接口实战指南，解锁商品口碑数据价值

一、精选高吸引力主题标题（多风格可选）爆款引流型吃透淘宝京东评论API！轻松抓取电商口碑数据，赋能竞品分析电商数据掘金：一文读懂淘宝、京东商品评论API接口全逻辑告别手动扒数据！主流电商评论API接口...

小红书笔记评论 API 接口深度解析（带全套 JSON 示例・技术实战版）

一、接口基础说明1. 接口基础信息接口路径：/api/v1/note/comment/list（小红书开放平台标准评论接口）请求方式：POST鉴权规则：Header 携带Authorization:...

万邦api博客

TikTok 视频详情 & 列表 API 接口技术文档（带全套 JSON 样例・核心章节）

一、接口整体说明

1. 接口地址与入参

（1）用户作品列表（批量列表）

（2）单视频详情接口

二、接口原生返回 JSON（脱敏真实原版・列表 + 单详情）

1. 用户作品列表原始返回 JSON

2. 单条视频详情原生 JSON（精简）

三、原生 JSON 现存痛点

四、结构化解析后标准 JSON（业务落地模型，可直接入库 MySQL/ES）

五、异常返回 JSON（错误码参考，异常捕获必备）

六、核心解析实战要点

七、极简 Python 解析示例（配套实战代码）

八、落地业务场景

相关文章

淘宝商品详情API的常见错误排查有哪些？

欢迎来到我的博客~

多语言采集淘宝京东拍立淘按图搜索，API接口（json数据返回）

Python 实现速卖通（AliExpress）商品详情 API 数据准确性校验

电商评论API深度解析：淘宝、京东接口实战指南，解锁商品口碑数据价值

小红书笔记评论 API 接口深度解析（带全套 JSON 示例・技术实战版）

发表评论

Copyright Your WebSite.Some Rights Reserved.

Powered By Z-BlogPHP. Theme by TOYEAN.

万邦api博客

TikTok 视频详情 & 列表 API 接口技术文档（带全套 JSON 样例・核心章节）

一、接口整体说明

1. 接口地址与入参

（1）用户作品列表（批量列表）

（2）单视频详情接口

二、接口原生返回 JSON（脱敏真实原版・列表 + 单详情）

1. 用户作品列表原始返回 JSON

2. 单条视频详情原生 JSON（精简）

三、原生 JSON 现存痛点

四、结构化解析后标准 JSON（业务落地模型，可直接入库 MySQL/ES）

五、异常返回 JSON（错误码参考，异常捕获必备）

六、核心解析实战要点

七、极简 Python 解析示例（配套实战代码）

八、落地业务场景

相关文章

淘宝商品详情API的常见错误排查有哪些？

欢迎来到我的博客~

多语言采集淘宝京东拍立淘按图搜索，API接口（json数据返回）

Python 实现速卖通（AliExpress）商品详情 API 数据准确性校验

电商评论API深度解析：淘宝、京东接口实战指南，解锁商品口碑数据价值

小红书笔记评论 API 接口深度解析（带全套 JSON 示例・技术实战版）

发表评论 取消回复

Copyright Your WebSite.Some Rights Reserved.

Powered By Z-BlogPHP. Theme by TOYEAN.

发表评论