抖音 API
覆盖视频搜索、详情、评论、账号信息和账号作品。
覆盖视频搜索、详情、评论、账号信息和账号作品。
| 能力 | REST 路径 | 方法 | 积分/次 | MCP 工具 |
|---|---|---|---|---|
| 视频搜索 | /v1/douyin/video_search | POST | 13 | douyin_video_search |
| 视频详情 | /v1/douyin/video_detail | GET | 10 | douyin_video_detail |
| 视频评论 | /v1/douyin/video_comments | GET | 2 | douyin_video_comments |
| 账号信息 | /v1/douyin/user_info | GET | 2 | douyin_user_info |
| 账号作品 | /v1/douyin/user_videos | GET | 2 | douyin_user_videos |
抖音视频搜索
按关键词搜索抖音视频
- REST 路径:
/v1/douyin/video_search - 方法:
POST - MCP 工具:
douyin_video_search - 计费: 13 积分/次,仅成功返回数据时扣费
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword | string | 是 | 搜索关键词 |
cursor | integer | 否 | 翻页游标,取上一次响应返回值,首页传 0 |
sort_type | string | 否 | 排序:0=综合 1=最多点赞 2=最新发布 |
publish_time | string | 否 | 发布时间筛选:0=不限 1=最近一天 7=最近一周 180=最近半年 |
filter_duration | string | 否 | 时长过滤:0=不限 0-1=一分钟内 1-5=一到五分钟 5-10000=五分钟以上 |
content_type | string | 否 | 内容类型:0=不限 1=视频 2=图片 3=文章 |
search_id | string | 否 | 搜索会话 ID,翻页时取上一次响应返回值 |
backtrace | string | 否 | 翻页回溯标识,取上一次响应返回值 |
请求示例
curl -X POST "https://api.example.com/v1/douyin/video_search" \
-H "X-API-Key: $FIREFLY_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Request-Id: demo-douyin_video_search-001" \
-d '{
"keyword": "coffee"
}'抖音视频详情
按作品ID或分享链接获取抖音视频详情
- REST 路径:
/v1/douyin/video_detail - 方法:
GET - MCP 工具:
douyin_video_detail - 计费: 10 积分/次,仅成功返回数据时扣费
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
aweme_id | string | 至少提供:aweme_id / share_url | 作品id,与 share_url 二选一/Video id, either this or share_url |
share_url | string | 至少提供:aweme_id / share_url | 分享链接(如 https://v.douyin.com/xxxx),与 aweme_id 二选一/Share URL, either this or aweme_id |
need_anchor_info | boolean | 否 | 是否需要锚点信息(仅与 aweme_id 同用时生效;share_url 变体端点不支持此参数) |
请求示例
curl "https://api.example.com/v1/douyin/video_detail?aweme_id=AWEME_ID" \
-H "X-API-Key: $FIREFLY_API_KEY" \
-H "X-Request-Id: demo-douyin_video_detail-001"抖音视频评论
获取抖音视频评论
- REST 路径:
/v1/douyin/video_comments - 方法:
GET - MCP 工具:
douyin_video_comments - 计费: 2 积分/次,仅成功返回数据时扣费
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
aweme_id | string | 是 | 作品id/Video id |
cursor | integer | 否 | 游标/Cursor |
count | integer | 否 | 数量/Number |
请求示例
curl "https://api.example.com/v1/douyin/video_comments?aweme_id=AWEME_ID" \
-H "X-API-Key: $FIREFLY_API_KEY" \
-H "X-Request-Id: demo-douyin_video_comments-001"抖音账号信息
按 sec_user_id 获取抖音用户信息
- REST 路径:
/v1/douyin/user_info - 方法:
GET - MCP 工具:
douyin_user_info - 计费: 2 积分/次,仅成功返回数据时扣费
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
sec_user_id | string | 是 | 用户sec_user_id/User sec_user_id |
请求示例
curl "https://api.example.com/v1/douyin/user_info?sec_user_id=SEC_USER_ID" \
-H "X-API-Key: $FIREFLY_API_KEY" \
-H "X-Request-Id: demo-douyin_user_info-001"抖音账号作品
获取抖音用户主页作品列表
- REST 路径:
/v1/douyin/user_videos - 方法:
GET - MCP 工具:
douyin_user_videos - 计费: 2 积分/次,仅成功返回数据时扣费
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
sec_user_id | string | 是 | 用户sec_user_id/User sec_user_id |
max_cursor | integer | 否 | 最大游标/Maximum cursor |
count | integer | 否 | 每页数量/Number per page |
sort_type | integer | 否 | 排序类型/Sort type |
请求示例
curl "https://api.example.com/v1/douyin/user_videos?sec_user_id=SEC_USER_ID" \
-H "X-API-Key: $FIREFLY_API_KEY" \
-H "X-Request-Id: demo-douyin_user_videos-001"