---
title: "抖音 API 文档与接口目录"
description: "按任务选择 JustOneAPI 的第三方抖音 API：关键词视频搜索、视频详情、一级评论、评论回复和用户资料，查看参数文档与 Python 接入教程。"
---

# 抖音 API 文档与接口目录

JustOneAPI 提供第三方抖音数据 API，用于内容发现、已知视频查询和创作者研究。本目录的接口用于读取数据；官方账号授权、内容发布属于另外的开发需求。

## 按任务选择接口

- 按关键词发现视频：从[视频搜索 V4](./video-search-v4)开始。后续翻页同时传入 `page` 与 `searchId`，其中 `searchId` 取自上一次响应的 `data.business_config.next_page.search_id`，并保持关键词和筛选条件不变。
- 已有视频 ID：将它作为 `videoId` 传给[视频详情 V2](./video-details-v2)，或作为 `awemeId` 传给[视频评论 V1](./video-comments-v1)。一级评论下的回复通过[评论回复 V1](./comment-replies-v1)单独获取。
- 已知创作者：使用 `secUid` 调用[用户资料 V3](./user-profile-v3)或[用户发布视频 V1](./user-published-videos-v1)。

已有的[抖音视频搜索、详情和评论 Python 教程](https://justoneapi.com/zh/blog/douyin-video-data-api-tutorial)演示了设置采集上限并保存 JSON 响应的接入流程。接口权限、价格及可用试用额度以控制台为准；发起请求前请阅读[API 使用指南](../../usage)。搜索结果和返回评论均有覆盖边界，不能据此认定已取得全量数据。

本目录面向国内抖音。[国际 TikTok](../tiktok/)、[抖音电商](../douyin-e-commerce/)和[巨量星图](../douyin-creator-marketplace-xingtu/)分别有独立目录，请按实际需求选择。

## 可用接口

<div class="api-doc-table api-doc-table--platform">

| 接口 | 方法 | 说明 |
| --- | --- | --- |
| [视频搜索 \(V4\)](./video-search-v4) | `GET` | 按关键词搜索抖音视频，支持排序、发布时间、时长和分页筛选；后续页面需要上一页的搜索ID。用于支持内容发现和趋势研究。 |
| [图片帖子搜索 \(V1\)](./image-post-search-v1) | `GET` | 按关键词搜索抖音图片帖子，并使用搜索会话分页。第一页省略 searchId，之后使用上一次响应中的搜索 ID 继续。可用于视觉内容发现和话题研究。 |
| [热搜 \(V1\)](./hot-search-v1) | `GET` | 搜索抖音内容，支持可选的关键词、类别、视频类型、排序、分页、互动量和创作者粉丝数筛选。用于支持趋势发现和活动研究。 |
| [热门话题排行 \(V1\)](./hot-list-v1) | `GET` | 从抖音公开热榜获取当前话题排名。用于追踪热门话题并及时规划内容。 |
| [直播间搜索 \(V1\)](./live-room-search-v1) | `GET` | 通过创作者的抖音ID或昵称搜索抖音直播间，支持游标分页。用于寻找直播间，进行创作者发现和直播研究。 |
| [用户搜索 \(V2\)](./user-search-v2) | `GET` | 按关键词搜索抖音用户，支持基于页面的分页和可选的账号类型筛选。用于发现创作者、品牌或认证账号进行研究。 |
| [用户发布视频 \(V1\)](./user-published-videos-v1) | `GET` | 检索抖音用户发布的视频，支持游标分页以及最新或最热排序。用于浏览或监控创作者的公开视频输出。 |
| [视频详情 \(V2\)](./video-details-v2) | `GET` | 通过视频ID获取抖音视频详情。用于在内容审核、存档或相关分析之前查找已知视频。 |
| [视频评论 \(V1\)](./video-comments-v1) | `GET` | 通过aweme ID以分页方式获取抖音视频的顶级评论。用于查看观众反馈或分析已知视频的讨论。 |
| [评论回复 \(V1\)](./comment-replies-v1) | `GET` | 通过分页方式获取抖音视频顶级评论的回复。用于检查线索讨论并查看已知评论下的反馈。 |
| [用户资料 \(V3\)](./user-profile-v3) | `GET` | 通过secUid获取抖音用户资料。用于在监控相关内容或进行账号研究之前查看已知创作者或账号。 |
| [分享链接解析 \(V1\)](./share-link-resolution-v1) | `GET` | 解析一个支持的抖音短分享链接（指向视频）并返回其公开重定向URL。用于在后续的抖音内容查找或处理之前展开视频链接。 |

</div>

## 已移除接口

以下接口已从常规目录移除，但历史接口仍可使用。建议尽可能迁移到其他版本。

<div class="api-doc-table api-doc-table--platform">

| 接口 | 方法 | 说明 |
| --- | --- | --- |
| [视频搜索 \(V1\)](./video-search-v1) | `GET` | 通过移动应用流程搜索抖音视频。从关键词和可选过滤条件开始。后续只使用前次响应中的 data.business_config.next_page.search_id 继续；分页状态最多保留 24 小时。 |
| [用户发布视频 \(V3\)](./user-published-videos-v3) | `GET` | 通过游标分页获取抖音用户发布的视频。用于浏览已知创作者的公开视频历史或翻看视频页面。 |

</div>

