抖音 API

覆盖视频搜索、详情、评论、账号信息和账号作品。

覆盖视频搜索、详情、评论、账号信息和账号作品。

能力REST 路径方法积分/次MCP 工具
视频搜索/v1/douyin/video_searchPOST13douyin_video_search
视频详情/v1/douyin/video_detailGET10douyin_video_detail
视频评论/v1/douyin/video_commentsGET2douyin_video_comments
账号信息/v1/douyin/user_infoGET2douyin_user_info
账号作品/v1/douyin/user_videosGET2douyin_user_videos

抖音视频搜索

按关键词搜索抖音视频

  • REST 路径: /v1/douyin/video_search
  • 方法: POST
  • MCP 工具: douyin_video_search
  • 计费: 13 积分/次,仅成功返回数据时扣费
参数类型必填说明
keywordstring搜索关键词
cursorinteger翻页游标,取上一次响应返回值,首页传 0
sort_typestring排序:0=综合 1=最多点赞 2=最新发布
publish_timestring发布时间筛选:0=不限 1=最近一天 7=最近一周 180=最近半年
filter_durationstring时长过滤:0=不限 0-1=一分钟内 1-5=一到五分钟 5-10000=五分钟以上
content_typestring内容类型:0=不限 1=视频 2=图片 3=文章
search_idstring搜索会话 ID,翻页时取上一次响应返回值
backtracestring翻页回溯标识,取上一次响应返回值

请求示例

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_idstring至少提供:aweme_id / share_url作品id,与 share_url 二选一/Video id, either this or share_url
share_urlstring至少提供:aweme_id / share_url分享链接(如 https://v.douyin.com/xxxx),与 aweme_id 二选一/Share URL, either this or aweme_id
need_anchor_infoboolean是否需要锚点信息(仅与 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_idstring作品id/Video id
cursorinteger游标/Cursor
countinteger数量/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_idstring用户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_idstring用户sec_user_id/User sec_user_id
max_cursorinteger最大游标/Maximum cursor
countinteger每页数量/Number per page
sort_typeinteger排序类型/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"