Douyin 公开数据 API
获取公开账号和视频，搜索视频，采集一页评论或创作者视频，并查询已知直播间。
可用的 Douyin API
六个 API 覆盖账号、视频、评论、搜索和直播间场景。
可以获取哪些 Douyin 数据？
Douyin API 返回来自公开来源的标准化账号、短视频、评论和直播间记录。
账号与创作者视频
通过受支持的主页 URL 或 user_id 获取公开账号，或采集一页创作者视频。
视频详情、搜索与评论
查询受支持的视频引用，按 query 搜索固定第一页，或采集一页公开视频评论。
直播间详情
通过纯数字 room_id 获取一个已知直播间及可用主播、状态、媒体和可见受众字段。
Douyin API 契约概览
每个接口都只执行有边界的来源请求，并拒绝未声明参数。
| API 分组 | 起始输入 | 来源边界 |
|---|---|---|
| 账号与创作者视频 | url 或 user_id | 一个账号或一个来源页；创作者视频支持 results_limit 1–20 |
| 视频详情与评论 | 受支持 URL | 一条详情或一页评论；评论支持 results_limit 1–20 |
| 视频搜索 | 非空 query | 固定来源第一页，不接受 results_limit |
| 直播间 | 纯数字 room_id | 最多一条直播间记录 |
Douyin API 如何工作
六个接口都使用异步提交、轮询和读取已存储结果的流程。
1. 选择接口
根据已有公开引用选择账号、视频、评论、搜索或直播间接口。
2. 提交有效参数
只 POST 已声明字段，并保存返回的 task_id。
3. 读取标准化结果
轮询任务至终态，再读取 data.results.items；next_cursor 只用于已存储结果分页。
使用 SocQ API key 鉴权并提交非空 query。每个成功的 Douyin 任务固定消耗 0.10 积分。
curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"人工智能"}'
# 轮询 GET /v1/tasks/{task_id}
# 成功后读取 data.results.items常见 Douyin API 使用场景
创作者研究
把公开账号身份与一页创作者视频及可见互动数据结合起来。
内容与讨论分析
补全已知视频，建立主题搜索快照，并查看一页公开评论。
直播间观察
通过明确的数字 room_id 记录已知公开直播间快照。
限制与公开数据政策
这些接口通过有边界的来源请求读取公开数据，不提供账号操作或持续监控。
- user_id 接受 1–256 个 ASCII 字母、数字、冒号、下划线或连字符；主页 URL 必须位于受支持 Douyin 主机并包含 /user/{identifier}。
- room_id 必须是纯数字字符串；不要把长标识转换为 JavaScript number。
- 只有 User Videos 和 Video Comments 接受 results_limit，范围为 1–20，默认值为 20。
- Video Search 固定请求来源第一页；任务返回的 next_cursor 只分页读取该任务已存储记录。
- 每个成功的 Douyin 任务固定消耗 0.10 积分。
Douyin API 常见问题
Douyin API 是什么？
Douyin API 是一组获取公开账号、视频、评论、视频搜索结果和直播间详情并返回标准化记录的接口。
哪些接口接受 results_limit？
User Videos 和 Video Comments 接受 1–20 的整数；其他 Douyin 接口会拒绝 results_limit。
可以翻页采集来源数据吗？
不提供调用方控制的来源 cursor；返回的 next_cursor 只分页读取已完成任务中已存储的结果。
Douyin 请求如何计费？
每个成功任务固定消耗 0.10 SocQ 积分。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Instagram API
通过统一异步流程查询已知 username 或发现公开主页，并采集粉丝列表记录、关注关系、账号发布的帖子、标记主页的帖子、hashtag 结果、Reels、字幕文本、评论、账号计数、互动指标和媒体元数据。
YouTube API
通过统一异步流程采集受支持的公开 YouTube 频道资料、视频详情、频道视频、评论、Shorts、关键词与话题标签结果和可用字幕。
X API
获取公开账号、关注者与关注列表、帖子、回复、引用帖、转发用户、搜索结果和当前趋势，用于研究和监测。
Facebook API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕，获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。
Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。