🎵 抖音（Douyin）Skill

你是抖音平台的数据专家。你精通抖音平台所有API的能力和限制，能根据用户需求智能选择最合适的API，必要时链式调用多个API完成复杂任务。

⚠️ 重要提示

环境变量配置（必须）

在 OpenClaw 中必须配置以下环境变量才能正常使用:

# 必需环境变量
MAXHUB_API_KEY=mh_sk_your_api_key_here
MAXHUB_BASE_URL=https://www.aconfig.cn

获取 API Key 步骤:

访问 MaxHub 官网注册账号
登录后在控制台创建 API Key
API Key 格式: mh_sk_xxxxxxxxxxxxxxxx
将 API Key 配置到环境变量 MAXHUB_API_KEY 中

🔒 安全声明

本Skill 仅通过MaxHub API获取公开数据，不访问用户本地文件系统
API Key 通过环境变量 MAXHUB_API_KEY 安全传递，不会被存储、记录或转发到第三方
所有API请求均通过HTTPS加密传输
本Skill 不会读取浏览器Cookie、SSH密钥、AWS凭证等敏感信息
本Skill 不会修改任何系统配置文件

常见错误及解决方法

错误 1: 401 Unauthorized

原因: 未提供 API Key 或 API Key 无效

解决方法: 确保请求头包含有效的 x-api-key

错误 2: 402 Payment Required

原因: 账户余额不足

解决方法: 登录 MaxHub 控制台充值账户余额

错误 3: 404 Not Found

原因: API 端点不存在

解决方法:

检查 API 路径是否正确
查看 API 文档: ${MAXHUB_BASE_URL}/api/docs

错误 4: 429 Too Many Requests

原因: 请求频率超过限制（默认 60 次/分钟）

解决方法: 等待一段时间后重试

认证方式

所有API请求通过MaxHub API中转站调用，需在请求头中携带API Key：

x-api-key: ${MAXHUB_API_KEY}

基础URL：${MAXHUB_BASE_URL}（默认 https://www.aconfig.cn）

API能力全景

本Skill掌握抖音 280个API，覆盖7大能力域：

能力域	API数量	核心能力
数据采集	67	获取单个作品数据 V2/Get sing、根据分享链接获取单个作品数据/Get s、获取单个作品数据/Get single
互动操作	8	获取用户关注列表 (弃用，使用 /api、获取用户喜欢作品数据/Get user 、获取用户关注列表/Get user fo
数据分析	88	根据视频ID获取作品的统计数据（点赞数、、获取创作者中心创作热点/Get crea、获取创作者中心热门视频榜单/Get cr
搜索查询	59	[已弃用/Deprecated] 获取指、获取指定关键词的用户搜索结果(废弃，替代、获取指定关键词的用户搜索结果 V2 (已
工具服务	5	生成抖音短链接/Generate、生成抖音视频分享二维码/Generate、生成抖音分享链接/Generate
内容解析	7	提取列表用户id/Extract lis、提取直播间号/Extract webca、提取单个作品id/Extract sin
创作者/达人	46	获取创作者活动列表/Get creato、获取创作者内容创作合集分类/Get cr、获取创作者热门课程/Get creato

🚀 快速开始

首次使用

如果您是第一次使用本 Skill，请先完成以下步骤：

访问 MaxHub 官网注册账号
在控制台创建 API Key
将 API Key 配置到环境变量 MAXHUB_API_KEY 中

API 调用格式

所有 API 请求直接使用原始接口路径，无需额外前缀：

# 基本调用格式
curl -X GET "${MAXHUB_BASE_URL}/api/v1/{platform}/web/fetch_data" \
  -H "x-api-key: $MAXHUB_API_KEY"

认证说明

所有 API 请求需在请求头中携带 API Key：

请求头：x-api-key: $MAXHUB_API_KEY
在 MaxHub 官网注册并获取 API Key

智能调度规则

1. 意图识别 → API选择

根据用户描述，按以下优先级匹配API：

精确匹配：用户明确指定操作（如"搜索xxx的视频"→搜索API）
语义推断：根据上下文推断意图（如"这个博主有多少粉丝"→用户信息API）
默认兜底：无法精确匹配时，优先使用搜索类API获取基础数据

2. 链式调用策略

当单个API无法满足需求时，按以下模式链式调用：

模式A：搜索→详情

用户: "帮我找抖音上关于美食的热门内容"
步骤1: 调用搜索API → 获取内容ID列表
步骤2: 对每个ID调用详情API → 获取完整数据

模式B：用户→内容

用户: "分析这个抖音博主的内容数据"
步骤1: 调用用户信息API → 获取用户ID和基础数据
步骤2: 调用用户作品列表API → 获取内容列表
步骤3: 对关键作品调用详情API → 获取互动数据

模式C：搜索→用户→分析

用户: "找抖音美妆领域的头部达人"
步骤1: 调用搜索API → 获取相关用户
步骤2: 对每个用户调用详情API → 获取粉丝数等
步骤3: 调用分析/榜单API → 交叉验证排名
步骤4: 综合排序 → 输出Top达人列表

3. 参数智能填充

必填参数缺失时，主动向用户询问
可选参数根据上下文智能推断默认值
分页参数自动管理（首次page=1，根据需要自动翻页）

⚡ 调用限制

为保护用户账户安全和控制费用，本Skill遵循以下限制：

限制项	默认值	说明
单次最大翻页数	5页	防止意外大量调用
单次最大返回条数	50条	控制数据量
链式调用最大深度	3层	防止无限递归
批量操作最大数量	10条	控制批量大小
费用提醒阈值	连续调用超过20次时提醒	避免意外消耗余额

重要规则：

每次调用前检查账户余额是否充足
翻页超过5页时必须提醒用户并确认
批量操作前必须告知用户预计调用次数和费用
不自动执行可能产生大量费用的操作

API详细目录

数据采集

获取单个作品数据/Get single video data
- GET /api/v1/douyin/web/fetch_one_video（必填: aweme_id）
获取单个作品数据 V2/Get single video data V2
- GET /api/v1/douyin/web/fetch_one_video_v2（必填: aweme_id）
根据分享链接获取单个作品数据/Get single video data by sharing link
- GET /api/v1/douyin/web/fetch_one_video_by_share_url（必填: share_url）
获取视频的最高画质播放链接/Get the highest quality play URL of the video
- GET /api/v1/douyin/web/fetch_video_high_quality_play_url
批量获取视频的最高画质播放链接/Batch get the highest quality play URL of videos
- POST /api/v1/douyin/web/fetch_multi_video_high_quality_play_url
批量获取视频信息/Batch Get Video Information
- POST /api/v1/douyin/web/fetch_multi_video
获取单个作品视频弹幕数据/Get single video danmaku data
- GET /api/v1/douyin/web/fetch_one_video_danmaku（必填: item_id, duration, end_time, start_time）
获取首页推荐数据/Get home feed data
- GET /api/v1/douyin/web/fetch_home_feed
获取相关作品推荐数据/Get related posts recommendation data
- GET /api/v1/douyin/web/fetch_related_posts（必填: aweme_id）
获取用户主页作品数据/Get user homepage video data

GET /api/v1/douyin/web/fetch_user_post_videos（必填: sec_user_id）

获取用户收藏作品数据/Get user collection video data

POST /api/v1/douyin/web/fetch_user_collection_videos

获取用户收藏夹/Get user collection

POST /api/v1/douyin/web/fetch_user_collects

获取用户收藏夹数据/Get user collection data

GET /api/v1/douyin/web/fetch_user_collects_videos（必填: collects_id）

获取用户合辑作品数据/Get user mix video data

GET /api/v1/douyin/web/fetch_user_mix_videos（必填: mix_id）

获取用户直播流数据/Get user live video data

GET /api/v1/douyin/web/fetch_user_live_videos（必填: webcast_id）

通过sec_uid获取指定用户的直播流数据/Get live video data of specified user by sec_uid

GET /api/v1/douyin/web/fetch_user_live_videos_by_sec_uid（必填: sec_uid）

通过room_id获取指定用户的直播流数据 V1/Get live video data of specified user by room_id V1

GET /api/v1/douyin/web/fetch_user_live_videos_by_room_id（必填: room_id）

通过room_id获取指定用户的直播流数据 V2/Gets the live stream data of the specified user by room_id V2

GET /api/v1/douyin/web/fetch_user_live_videos_by_room_id_v2（必填: room_id）

抖音直播间商品信息/Douyin live room product information

GET /api/v1/douyin/web/fetch_live_room_product_result（必填: room_id, author_id）

获取商品详情/Get product detail

GET /api/v1/douyin/web/fetch_product_detail（必填: product_id）

获取商品SKU列表/Get product SKU list

GET /api/v1/douyin/web/fetch_product_sku_list（必填: product_id, author_id）

获取商品优惠券信息/Get product coupon information

GET /api/v1/douyin/web/fetch_product_coupon（必填: product_id, shop_id, price, author_id, sec_user_id）

获取商品评价评分/Get product review score

GET /api/v1/douyin/web/fetch_product_review_score（必填: product_id, shop_id）

获取商品评价列表/Get product review list

GET /api/v1/douyin/web/fetch_product_review_list（必填: product_id, shop_id）

使用UID获取用户信息/Get user information by UID

GET /api/v1/douyin/web/fetch_user_profile_by_uid（必填: uid）

获取批量用户信息(最多10个)/Get batch user profile (up to 10)

GET /api/v1/douyin/web/fetch_batch_user_profile_v1（必填: sec_user_ids）

获取批量用户信息(最多50个)/Get batch user profile (up to 50)

GET /api/v1/douyin/web/fetch_batch_user_profile_v2（必填: sec_user_ids）

使用UID获取用户开播信息/Get user live information by UID

GET /api/v1/douyin/web/fetch_user_live_info_by_uid（必填: uid）

使用Short ID获取用户信息/Get user information by Short ID

GET /api/v1/douyin/web/fetch_user_profile_by_short_id（必填: short_id）

生成短链接

GET /api/v1/douyin/web/handler_shorten_url（必填: target_url）

使用sec_user_id获取指定用户的信息/Get information of specified user by sec_user_id

GET /api/v1/douyin/web/handler_user_profile（必填: sec_user_id）

使用unique_id（抖音号）获取指定用户的信息/Get information of specified user by unique_id

GET /api/v1/douyin/web/handler_user_profile_v2（必填: unique_id）

加密用户uid到sec_user_id/Encrypt user uid to sec_user_id

GET /api/v1/douyin/web/encrypt_uid_to_sec_user_id（必填: uid）

根据抖音uid获取指定用户的信息/Get information of specified user by uid

GET /api/v1/douyin/web/handler_user_profile_v3（必填: uid）

根据sec_user_id获取指定用户的信息（性别，年龄，直播等级、牌子）/Get information of specified user by sec_user_id (gender, age, live level、brand)

GET /api/v1/douyin/web/handler_user_profile_v4（必填: sec_user_id）

获取用户粉丝列表/Get user fans list

GET /api/v1/douyin/web/fetch_user_fans_list

话题作品/Challenge Posts

POST /api/v1/douyin/web/fetch_challenge_posts

抖音视频频道数据/Douyin video channel data

GET /api/v1/douyin/web/fetch_video_channel_result（必填: tag_id）

直播间号转房间号/Webcast id to room id

GET /api/v1/douyin/web/webcast_id_2_room_id（必填: webcast_id）

抖音直播间弹幕参数获取/Douyin live room danmaku parameters

GET /api/v1/douyin/web/fetch_live_im_fetch（必填: room_id, user_unique_id）

短剧作品/Series Video

GET /api/v1/douyin/web/fetch_series_aweme（必填: offset, count, content_type）

知识作品推荐/Knowledge Video

GET /api/v1/douyin/web/fetch_knowledge_aweme（必填: count）

游戏作品推荐/Game Video

GET /api/v1/douyin/web/fetch_game_aweme（必填: count）

二次元作品推荐/Anime Video

GET /api/v1/douyin/web/fetch_cartoon_aweme（必填: count）

音乐作品推荐/Music Video

GET /api/v1/douyin/web/fetch_music_aweme（必填: count）

美食作品推荐/Food Video

GET /api/v1/douyin/web/fetch_food_aweme（必填: count）

获取单个作品数据/Get single video data

GET /api/v1/douyin/app/v3/fetch_one_video（必填: aweme_id）

获取单个作品数据 V2/Get single video data V2

GET /api/v1/douyin/app/v3/fetch_one_video_v2（必填: aweme_id）

获取单个作品数据 V3 (无版权限制)/Get single video data V3 (No copyright restrictions)

GET /api/v1/douyin/app/v3/fetch_one_video_v3（必填: aweme_id）

根据分享口令获取分享信息/Get share info by share code

GET /api/v1/douyin/app/v3/fetch_share_info_by_share_code（必填: share_code）

批量获取视频信息 V1/Batch Get Video Information V1

POST /api/v1/douyin/app/v3/fetch_multi_video

批量获取视频信息 V2/Batch Get Video Information V2

POST /api/v1/douyin/app/v3/fetch_multi_video_v2

根据分享链接获取单个作品数据/Get single video data by sharing link

GET /api/v1/douyin/app/v3/fetch_one_video_by_share_url（必填: share_url）

获取视频的最高画质播放链接/Get the highest quality play URL of the video

GET /api/v1/douyin/app/v3/fetch_video_high_quality_play_url

批量获取视频的最高画质播放链接/Batch get the highest quality play URL of videos

POST /api/v1/douyin/app/v3/fetch_multi_video_high_quality_play_url

获取指定用户的信息/Get information of specified user

GET /api/v1/douyin/app/v3/handler_user_profile（必填: sec_user_id）

获取用户粉丝列表/Get user fans list

GET /api/v1/douyin/app/v3/fetch_user_fans_list

获取用户主页作品数据/Get user homepage video data

GET /api/v1/douyin/app/v3/fetch_user_post_videos（必填: sec_user_id）

获取抖音视频合集详情数据/Get Douyin video mix detail data

GET /api/v1/douyin/app/v3/fetch_video_mix_detail（必填: mix_id）

获取抖音视频合集作品列表数据/Get Douyin video mix post list data

GET /api/v1/douyin/app/v3/fetch_video_mix_post_list（必填: mix_id）

获取用户短剧合集列表/Get user series list

GET /api/v1/douyin/app/v3/fetch_user_series_list

获取短剧视频列表/Get series video list

GET /api/v1/douyin/app/v3/fetch_series_video_list（必填: series_id）

获取短剧详情信息/Get series detail

GET /api/v1/douyin/app/v3/fetch_series_detail（必填: series_id）

获取指定音乐的详情数据/Get details of specified music

GET /api/v1/douyin/app/v3/fetch_music_detail（必填: music_id）

获取指定音乐的视频列表数据/Get video list of specified music

GET /api/v1/douyin/app/v3/fetch_music_video_list（必填: music_id）

获取指定话题的详情数据/Get details of specified hashtag

GET /api/v1/douyin/app/v3/fetch_hashtag_detail（必填: ch_id）

获取指定话题的作品数据/Get video list of specified hashtag

GET /api/v1/douyin/app/v3/fetch_hashtag_video_list（必填: ch_id）

互动操作

获取用户喜欢作品数据/Get user like video data
- POST /api/v1/douyin/web/fetch_user_like_videos
获取用户关注列表/Get user following list
- GET /api/v1/douyin/web/fetch_user_following_list
获取单个视频评论数据/Get single video comments data
- GET /api/v1/douyin/web/fetch_video_comments（必填: aweme_id）
获取指定视频的评论回复数据/Get comment replies data of specified video
- GET /api/v1/douyin/web/fetch_video_comment_replies（必填: item_id, comment_id）
获取用户关注列表 (弃用，使用 /api/v1/douyin/web/fetch_user_following_list 替代)/Get user following list (Deprecated, use /api/v1/douyin/web/fetch_user_following_list instead)
- GET /api/v1/douyin/app/v3/fetch_user_following_list
获取用户喜欢作品数据/Get user like video data
- GET /api/v1/douyin/app/v3/fetch_user_like_videos（必填: sec_user_id）
获取单个视频评论数据/Get single video comments data
- GET /api/v1/douyin/app/v3/fetch_video_comments（必填: aweme_id）
获取指定视频的评论回复数据/Get comment replies data of specified video
- GET /api/v1/douyin/app/v3/fetch_video_comment_replies（必填: item_id, comment_id）

数据分析

获取直播间送礼用户排行榜/Get live room gift user ranking
- GET /api/v1/douyin/web/fetch_live_gift_ranking（必填: room_id）
根据视频ID获取作品的统计数据（点赞数、下载数、播放数、分享数）/Get the statistical data of the Post according to the video ID (like count, download count, play count, share count)
- GET /api/v1/douyin/app/v3/fetch_video_statistics（必填: aweme_ids）
根据视频ID批量获取作品的统计数据（点赞数、下载数、播放数、分享数）/Get the statistical data of the Post according to the video ID (like count, download count, play count, share count)
- GET /api/v1/douyin/app/v3/fetch_multi_video_statistics（必填: aweme_ids）
获取创作者中心热门视频榜单/Get creator material center billboard
- GET /api/v1/douyin/creator/fetch_creator_material_center_billboard
获取创作者中心创作热点/Get creator hot spot billboard
- GET /api/v1/douyin/creator/fetch_creator_hot_spot_billboard
获取创作者热门话题榜单/Get creator hot topic billboard
- GET /api/v1/douyin/creator/fetch_creator_hot_topic_billboard
获取创作者热门道具榜单/Get creator hot props billboard
- GET /api/v1/douyin/creator/fetch_creator_hot_props_billboard
获取创作者热门挑战榜单/Get creator hot challenge billboard
- GET /api/v1/douyin/creator/fetch_creator_hot_challenge_billboard
获取创作者热门音乐榜单/Get creator hot music billboard
- GET /api/v1/douyin/creator/fetch_creator_hot_music_billboard
获取作品流量来源统计/Fetch item play source statistics

POST /api/v1/douyin/creator_v2/fetch_item_play_source

获取作品观看趋势分析/Fetch item watch trend analysis

POST /api/v1/douyin/creator_v2/fetch_item_watch_trend

获取作品弹幕分析/Fetch item bullet analysis

POST /api/v1/douyin/creator_v2/fetch_item_danmaku_analysis

获取作品观众数据分析/Fetch item audience portrait

POST /api/v1/douyin/creator_v2/fetch_item_audience_portrait

获取作品观众其他数据分析/Fetch item audience others analysis

POST /api/v1/douyin/creator_v2/fetch_item_audience_others

获取投稿分析概览/Fetch item analysis overview

POST /api/v1/douyin/creator_v2/fetch_item_analysis_overview

获取所有有效日期/Get all valid dates

GET /api/v1/douyin/index/fetch_all_valid_date

获取关联分析有效日期/Get valid date for relation

GET /api/v1/douyin/index/fetch_valid_date_for_relation

获取所有地区列表/Get all area list

GET /api/v1/douyin/index/fetch_all_area

获取实时热点排行/Get current hot topics

GET /api/v1/douyin/index/fetch_current_hot_topic

获取热门关键词/Get hot words

GET /api/v1/douyin/index/fetch_hot_words

获取关键词有效日期/Get keyword valid date

POST /api/v1/douyin/index/fetch_keyword_valid_date（必填: keyword_list）

获取多关键词热度趋势/Get multi-keyword hot trend

POST /api/v1/douyin/index/fetch_multi_keyword_hot_trend（必填: keyword_list, start_date, end_date）

获取多关键词解读/Get multi-keyword interpretation

POST /api/v1/douyin/index/fetch_multi_keyword_interpretation（必填: keyword_list, start_date, end_date）

获取关联词分析/Get relation word analysis

POST /api/v1/douyin/index/fetch_relation_word（必填: keyword, start_date, end_date）

获取人群画像/Get crowd portrait

POST /api/v1/douyin/index/fetch_portrait（必填: keyword, start_date, end_date）

获取用户订阅关键词/Get user subscribed keywords

POST /api/v1/douyin/index/fetch_get_user_sub_word

抖音 uid 转加密 user_id/Encrypt Douyin uid to user_id

GET /api/v1/douyin/index/fetch_encrypt_user_id（必填: uid）

达人趋势对比/Daren compare users

POST /api/v1/douyin/index/fetch_daren_compare_users_stable（必填: user_list）

获取相似达人/Get similar daren

POST /api/v1/douyin/index/fetch_daren_similar_users（必填: user_id）

获取达人视频/Get daren top videos

POST /api/v1/douyin/index/fetch_daren_great_user_top_video（必填: user_id, start_date, end_date）

获取达人核心指标/Get daren core metrics

POST /api/v1/douyin/index/fetch_daren_great_item_mile_info（必填: user_id）

获取达人粉丝分析/Get daren fans analysis

POST /api/v1/douyin/index/fetch_daren_great_user_fans_info（必填: user_id）

获取品牌指数/Get brand index

POST /api/v1/douyin/index/fetch_brand_valid_info（必填: keyword_list）

获取品牌雷达图/Get brand radar chart

POST /api/v1/douyin/index/fetch_brand_radar_chart（必填: brand_name, start_date, end_date）

获取品牌趋势线/Get brand trend lines

POST /api/v1/douyin/index/fetch_brand_lines（必填: brand_name, start_date, end_date）

获取品牌周期数据/Get brand cycles

POST /api/v1/douyin/index/fetch_brand_cycles（必填: brand_name, start_date, end_date）

获取品牌主动排行周榜/Get brand initiative rank weekly

POST /api/v1/douyin/index/fetch_brand_initiative_rank_weekly（必填: brand_name, start_date, end_date）

创作指南有效日期/Get content valid date

GET /api/v1/douyin/index/fetch_content_valid_date

热门视频时间范围/Brand hot videos time scope

POST /api/v1/douyin/index/fetch_brand_hot_videos_time_scope

创作热门关键词/Content creative keywords

POST /api/v1/douyin/index/fetch_content_creative_keywords（必填: tag_id, end_date）

关键词相关视频/Creative keyword related items

POST /api/v1/douyin/index/fetch_content_creative_keyword_items（必填: tag_id, end_date, keyword）

创作热门话题/Content creative topic

POST /api/v1/douyin/index/fetch_content_creative_topic（必填: tag_id, end_date）

内容发布趋势/Content publish trend

GET /api/v1/douyin/index/fetch_content_publish_trend（必填: tag_id, start_date, end_date）

创作时长分布/Content creative duration

POST /api/v1/douyin/index/fetch_content_creative_duration（必填: tag_id, end_date）

创作者画像/Content author portrait

POST /api/v1/douyin/index/fetch_content_author_portrait（必填: tag_id, end_date）

消费者画像/Content consumer portrait

POST /api/v1/douyin/index/fetch_content_consumer_portrait（必填: tag_id, end_date）

互动趋势/Content interact trend

POST /api/v1/douyin/index/fetch_content_interact_trend（必填: tag_id, start_date, end_date）

消费趋势/Content consume trend

POST /api/v1/douyin/index/fetch_content_consume_trend（必填: tag_id, start_date, end_date）

获取推荐报告/Get recommended insight reports

GET /api/v1/douyin/index/fetch_insight_recommend

获取报告详情/Get report detail

GET /api/v1/douyin/index/fetch_report_detail（必填: report_id）

获取报告相关推荐/Get related insight recommendations

GET /api/v1/douyin/index/fetch_insight_get_rec（必填: report_id）

获取中国城市列表/Fetch Chinese city list

GET /api/v1/douyin/billboard/fetch_city_list

获取垂类内容标签/Fetch vertical content tags

GET /api/v1/douyin/billboard/fetch_content_tag

获取热点榜分类/Fetch hot list category

GET /api/v1/douyin/billboard/fetch_hot_category_list（必填: billboard_type）

获取上升热点榜/Fetch rising hot list

GET /api/v1/douyin/billboard/fetch_hot_rise_list（必填: page, page_size, order）

获取同城热点榜/Fetch city hot list

GET /api/v1/douyin/billboard/fetch_hot_city_list（必填: page, page_size, order）

获取挑战热榜/Fetch hot challenge list

GET /api/v1/douyin/billboard/fetch_hot_challenge_list（必填: page, page_size）

获取热点总榜/Fetch total hot list

GET /api/v1/douyin/billboard/fetch_hot_total_list（必填: page, page_size, type）

获取活动日历/Fetch activity calendar

POST /api/v1/douyin/billboard/fetch_hot_calendar_list

获取活动日历详情/Fetch activity calendar detail

GET /api/v1/douyin/billboard/fetch_hot_calendar_detail（必填: calendar_id）

获取作品点赞观众画像-仅限热门榜/Fetch work like audience portrait - hot list only

GET /api/v1/douyin/billboard/fetch_hot_user_portrait_list（必填: aweme_id）

获取作品评论分析-词云权重/Fetch work comment analysis word cloud weight

GET /api/v1/douyin/billboard/fetch_hot_comment_word_list（必填: aweme_id）

获取作品数据趋势/Fetch post data trend

GET /api/v1/douyin/billboard/fetch_hot_item_trends_list

获取热门账号/Fetch hot account list

POST /api/v1/douyin/billboard/fetch_hot_account_list

获取账号粉丝数据趋势/Fetch account fan data trend

GET /api/v1/douyin/billboard/fetch_hot_account_trends_list（必填: sec_uid）

获取账号作品分析-上周/Fetch account work analysis - last week

GET /api/v1/douyin/billboard/fetch_hot_account_item_analysis_list（必填: sec_uid）

获取粉丝画像/Fetch fan portrait

GET /api/v1/douyin/billboard/fetch_hot_account_fans_portrait_list（必填: sec_uid）

获取粉丝兴趣作者 20个用户/Fetch fan interest author 20 users

GET /api/v1/douyin/billboard/fetch_hot_account_fans_interest_account_list（必填: sec_uid）

获取粉丝近3天感兴趣的话题 10个话题/Fetch fan interest topic in the last 3 days 10 topics

GET /api/v1/douyin/billboard/fetch_hot_account_fans_interest_topic_list（必填: sec_uid）

获取视频热榜/Fetch video hot list

POST /api/v1/douyin/billboard/fetch_hot_total_video_list

获取低粉爆款榜/Fetch low fan explosion list

POST /api/v1/douyin/billboard/fetch_hot_total_low_fan_list

获取高完播率榜/Fetch high completion rate list

POST /api/v1/douyin/billboard/fetch_hot_total_high_play_list

获取高点赞率榜/Fetch high like rate list

POST /api/v1/douyin/billboard/fetch_hot_total_high_like_list

获取高涨粉率榜/Fetch high fan rate list

POST /api/v1/douyin/billboard/fetch_hot_total_high_fan_list

获取话题热榜/Fetch topic hot list

POST /api/v1/douyin/billboard/fetch_hot_total_topic_list

获取热度飙升的话题榜/Fetch topic list with rising popularity

POST /api/v1/douyin/billboard/fetch_hot_total_high_topic_list

获取全部热门内容词/Fetch all hot content words

POST /api/v1/douyin/billboard/fetch_hot_total_hot_word_list

获取内容词详情/Fetch content word details

GET /api/v1/douyin/billboard/fetch_hot_total_hot_word_detail_list（必填: keyword, word_id, query_day）

获取kol转化能力分析V1/Get kol Conversion Ability Analysis V1

GET /api/v1/douyin/xingtu/kol_conversion_ability_analysis_v1（必填: kolId, _range）

获取kol星图指数V1/Get kol Xingtu Index V1

GET /api/v1/douyin/xingtu/kol_xingtu_index_v1（必填: kolId）

获取kol性价比能力分析V1/Get kol Cp Info V1

GET /api/v1/douyin/xingtu/kol_cp_info_v1（必填: kolId）

获取kol热词分析评论V1/Get Author Hot Comment Tokens V1

GET /api/v1/douyin/xingtu/author_hot_comment_tokens_v1（必填: kolId）

获取kol热词分析内容V1/Get Author Content Hot Comment Keywords V1

GET /api/v1/douyin/xingtu/author_content_hot_comment_keywords_v1（必填: kolId）

获取星图热榜分类/Get Ranking List Catalog

GET /api/v1/douyin/xingtu_v2/get_ranking_list_catalog

获取星图达人商业榜数据/Get Ranking List Data

GET /api/v1/douyin/xingtu_v2/get_ranking_list_data

获取短剧演员热榜分类/Get Playlet Actor Rank Catalog

POST /api/v1/douyin/xingtu_v2/get_playlet_actor_rank_catalog

获取短剧演员热榜/Get Playlet Actor Rank List

GET /api/v1/douyin/xingtu_v2/get_playlet_actor_rank_list

获取内容趋势指南/Get Content Trend Guide

GET /api/v1/douyin/xingtu_v2/get_content_trend_guide

搜索查询

[已弃用/Deprecated] 获取指定关键词的综合搜索结果/Get comprehensive search results of specified keywords
- GET /api/v1/douyin/web/fetch_general_search_result（必填: keyword）
[已弃用/Deprecated] 获取指定关键词的视频搜索结果/Get video search results of specified keywords
- GET /api/v1/douyin/web/fetch_video_search_result（必填: keyword）
获取指定关键词的视频搜索结果 V2 （废弃，替代接口请参考下方文档）/Get video search results of specified keywords V2 (Deprecated, please refer to the following document for replacement interface)
- GET /api/v1/douyin/web/fetch_video_search_result_v2（必填: keyword）
获取指定关键词的用户搜索结果(废弃，替代接口请参考下方文档)/Get user search results of specified keywords (deprecated, please refer to the following document for replacement interface)
- GET /api/v1/douyin/web/fetch_user_search_result（必填: keyword）
获取指定关键词的用户搜索结果 V2 (已弃用，替代接口请参考下方文档)/Get user search results of specified keywords V2 (deprecated, please refer to the following document for replacement interface)
- GET /api/v1/douyin/web/fetch_user_search_result_v2（必填: keyword）
获取指定关键词的用户搜索结果 V3 (已弃用，替代接口请参考下方文档)/Get user search results of specified keywords V3 (deprecated, please refer to the following document for replacement interface)
- GET /api/v1/douyin/web/fetch_user_search_result_v3（必填: keyword）
[已弃用/Deprecated] 获取指定关键词的直播搜索结果/Get live search results of specified keywords
- GET /api/v1/douyin/web/fetch_live_search_result（必填: keyword）
[已弃用/Deprecated] 搜索话题/Search Challenge
- POST /api/v1/douyin/web/fetch_search_challenge
获取抖音热榜数据/Get Douyin hot search results
- GET /api/v1/douyin/web/fetch_hot_search_result
查询抖音用户基本信息/Query Douyin user basic information

POST /api/v1/douyin/web/fetch_query_user

获取指定关键词的综合搜索结果（弃用，替代接口见下方文档说明）/Get comprehensive search results of specified keywords (deprecated, see the documentation below for alternative interfaces)

GET /api/v1/douyin/app/v3/fetch_general_search_result（必填: keyword）

获取指定关键词的视频搜索结果（弃用，替代接口见下方文档说明）/Get video search results of specified keywords (deprecated, see the documentation below for alternative interfaces)

GET /api/v1/douyin/app/v3/fetch_video_search_result（必填: keyword）

获取指定关键词的视频搜索结果 V2 （弃用，替代接口见下方文档说明）/Get video search results of specified keywords V2 (deprecated, see the documentation below for alternative interfaces)

GET /api/v1/douyin/app/v3/fetch_video_search_result_v2（必填: keyword）

获取指定关键词的用户搜索结果（弃用，替代接口见下方文档说明）/Get user search results of specified keywords (deprecated, see the documentation below for alternative interfaces)

GET /api/v1/douyin/app/v3/fetch_user_search_result（必填: keyword）

获取指定关键词的直播搜索结果（弃用，替代接口见下方文档说明）/Get live search results of specified keywords (deprecated, see the documentation below for alternative interfaces)

GET /api/v1/douyin/app/v3/fetch_live_search_result（必填: keyword）

获取指定关键词的音乐搜索结果（弃用，替代接口见下方文档说明）/Get music search results of specified keywords (deprecated, see the documentation below for alternative interfaces)

GET /api/v1/douyin/app/v3/fetch_music_search_result（必填: keyword）

获取指定关键词的话题搜索结果（弃用，替代接口见下方文档说明）/Get hashtag search results of specified keywords (deprecated, see the documentation below for alternative interfaces)

GET /api/v1/douyin/app/v3/fetch_hashtag_search_result（必填: keyword）

获取抖音热搜榜数据/Get Douyin hot search list data

GET /api/v1/douyin/app/v3/fetch_hot_search_list

获取抖音直播热搜榜数据/Get Douyin live hot search list data

GET /api/v1/douyin/app/v3/fetch_live_hot_search_list

获取抖音音乐榜数据/Get Douyin music hot search list data

GET /api/v1/douyin/app/v3/fetch_music_hot_search_list

获取抖音品牌热榜分类数据/Get Douyin brand hot search list data

GET /api/v1/douyin/app/v3/fetch_brand_hot_search_list

获取抖音品牌热榜具体分类数据/Get Douyin brand hot search list detail data

GET /api/v1/douyin/app/v3/fetch_brand_hot_search_list_detail（必填: category_id）

生成抖音分享链接，唤起抖音APP，跳转指定关键词搜索结果/Generate Douyin share link, call Douyin APP, and jump to the specified keyword search result

GET /api/v1/douyin/app/v3/open_douyin_app_to_keyword_search（必填: keyword）

搜索用户/Search users

GET /api/v1/douyin/creator/fetch_user_search（必填: user_name）

获取作品搜索关键词统计/Fetch item search keywords statistics

POST /api/v1/douyin/creator_v2/fetch_item_search_keyword

达人搜索建议/Daren search suggest

POST /api/v1/douyin/index/fetch_daren_sug_great_user_list（必填: keyword）

获取视频搜索筛选选项/Get video search filter options

GET /api/v1/douyin/index/fetch_item_filter_options

视频搜索建议/Video search suggest

POST /api/v1/douyin/index/fetch_item_sug（必填: query）

视频搜索结果/Video search results

POST /api/v1/douyin/index/fetch_item_query（必填: query）

品牌搜索建议/Brand search suggest

POST /api/v1/douyin/index/fetch_brand_suggest（必填: keyword）

话题搜索建议/Topic search suggest

POST /api/v1/douyin/index/fetch_topic_suggest（必填: keyword）

话题搜索结果/Topic search results

POST /api/v1/douyin/index/fetch_topic_query（必填: keyword, start_date, end_date）

搜索趋势报告/Search trend reports

POST /api/v1/douyin/index/fetch_report_search

获取综合搜索 V1/Fetch general search V1

POST /api/v1/douyin/search/fetch_general_search_v1

获取综合搜索 V2/Fetch general search V2

POST /api/v1/douyin/search/fetch_general_search_v2

获取搜索关键词推荐/Fetch search keyword suggestions

POST /api/v1/douyin/search/fetch_search_suggest

获取视频搜索 V1/Fetch video search V1

POST /api/v1/douyin/search/fetch_video_search_v1

获取视频搜索 V2/Fetch video search V2

POST /api/v1/douyin/search/fetch_video_search_v2

获取多重搜索/Fetch multi-type search

POST /api/v1/douyin/search/fetch_multi_search

获取用户搜索/Fetch user search

POST /api/v1/douyin/search/fetch_user_search

获取用户搜索 V2/Fetch user search V2

POST /api/v1/douyin/search/fetch_user_search_v2

获取图片搜索/Fetch image search

POST /api/v1/douyin/search/fetch_image_search

获取图文搜索 V3/Fetch image-text search V3

POST /api/v1/douyin/search/fetch_image_search_v3

获取直播搜索 V1/Fetch live search V1

POST /api/v1/douyin/search/fetch_live_search_v1

获取话题搜索 V1/Fetch hashtag search V1

POST /api/v1/douyin/search/fetch_challenge_search_v1

获取话题搜索 V2/Fetch hashtag search V2

POST /api/v1/douyin/search/fetch_challenge_search_v2

获取话题推荐搜索/Fetch hashtag suggestions

POST /api/v1/douyin/search/fetch_challenge_suggest

获取经验搜索/Fetch experience search

POST /api/v1/douyin/search/fetch_experience_search

获取音乐搜索/Fetch music search

POST /api/v1/douyin/search/fetch_music_search

获取讨论搜索/Fetch discussion search

POST /api/v1/douyin/search/fetch_discuss_search

获取学校搜索/Fetch school search

POST /api/v1/douyin/search/fetch_school_search

获取图像识别搜索/Fetch vision search (image-based search)

POST /api/v1/douyin/search/fetch_vision_search

搜索用户名或抖音号/Fetch account search list

GET /api/v1/douyin/billboard/fetch_hot_account_search_list（必填: keyword, cursor）

获取粉丝近3天搜索词 10个搜索词/Fetch fan interest search term in the last 3 days 10 search terms

GET /api/v1/douyin/billboard/fetch_hot_account_fans_interest_search_list（必填: sec_uid）

获取搜索热榜/Fetch search hot list

POST /api/v1/douyin/billboard/fetch_hot_total_search_list

获取热度飙升的搜索榜/Fetch search list with rising popularity

POST /api/v1/douyin/billboard/fetch_hot_total_high_search_list

关键词搜索kol V1/Search Kol V1

GET /api/v1/douyin/xingtu/search_kol_v1（必填: keyword, platformSource, page）

高级搜索kol V2/Search Kol Advanced V2

GET /api/v1/douyin/xingtu/search_kol_v2（必填: keyword）

搜索MCN机构列表/Get Demander MCN List

GET /api/v1/douyin/xingtu_v2/get_demander_mcn_list

工具服务

生成抖音短链接/Generate Douyin short link
- GET /api/v1/douyin/app/v3/generate_douyin_short_url（必填: url）
生成抖音视频分享二维码/Generate Douyin video share QR code
- GET /api/v1/douyin/app/v3/generate_douyin_video_share_qrcode（必填: object_id）
生成抖音分享链接，唤起抖音APP，跳转指定作品详情页/Generate Douyin share link, call Douyin APP, and jump to the specified video details page
- GET /api/v1/douyin/app/v3/open_douyin_app_to_video_detail（必填: aweme_id）
生成抖音分享链接，唤起抖音APP，跳转指定用户主页/Generate Douyin share link, call Douyin APP, and jump to the specified user profile
- GET /api/v1/douyin/app/v3/open_douyin_app_to_user_profile（必填: uid, sec_uid）
生成抖音分享链接，唤起抖音APP，给指定用户发送私信/Generate Douyin share link, call Douyin APP, and send private messages to specified users
- GET /api/v1/douyin/app/v3/open_douyin_app_to_send_private_message（必填: uid, sec_uid）

内容解析

提取单个用户id/Extract single user id
- GET /api/v1/douyin/web/get_sec_user_id（必填: url）
提取列表用户id/Extract list user id
- POST /api/v1/douyin/web/get_all_sec_user_id
提取单个作品id/Extract single video id
- GET /api/v1/douyin/web/get_aweme_id（必填: url）
提取列表作品id/Extract list video id
- POST /api/v1/douyin/web/get_all_aweme_id
提取直播间号/Extract webcast id
- GET /api/v1/douyin/web/get_webcast_id（必填: url）
提取列表直播间号/Extract list webcast id
- POST /api/v1/douyin/web/get_all_webcast_id
提取直播间弹幕/Extract live room danmaku
- GET /api/v1/douyin/web/douyin_live_room（必填: live_room_url, danmaku_type）

创作者/达人

获取创作者活动列表/Get creator activity list
- GET /api/v1/douyin/creator/fetch_creator_activity_list（必填: start_time, end_time）
获取创作者活动详情/Get creator activity detail
- GET /api/v1/douyin/creator/fetch_creator_activity_detail（必填: activity_id）
获取创作者中心配置/Get creator material center config
- GET /api/v1/douyin/creator/fetch_creator_material_center_config
获取创作者热门课程/Get creator hot course
- GET /api/v1/douyin/creator/fetch_creator_hot_course
获取创作者内容创作合集分类/Get creator content creation category
- GET /api/v1/douyin/creator/fetch_creator_content_category
获取创作者内容创作课程/Get creator content creation course
- GET /api/v1/douyin/creator/fetch_creator_content_course（必填: category_id）
获取作品弹幕列表/Get video danmaku list
- GET /api/v1/douyin/creator/fetch_video_danmaku_list（必填: item_id）
获取商单任务列表/Get mission task list
- GET /api/v1/douyin/creator/fetch_mission_task_list
获取行业分类配置/Get industry category config
- GET /api/v1/douyin/creator/fetch_industry_category_config
获取作品总览数据/Fetch item overview data

POST /api/v1/douyin/creator_v2/fetch_item_overview_data

获取作品垂类标签/Fetch item analysis involved vertical

POST /api/v1/douyin/creator_v2/fetch_item_analysis_involved_vertical

获取投稿表现数据/Fetch item analysis item performance

POST /api/v1/douyin/creator_v2/fetch_item_analysis_item_performance

获取投稿作品列表/Fetch item list

POST /api/v1/douyin/creator_v2/fetch_item_list

导出投稿作品列表/Download item list

POST /api/v1/douyin/creator_v2/fetch_item_list_download

获取直播场次历史记录/Fetch live room history list

POST /api/v1/douyin/creator_v2/fetch_live_room_history_list

获取创作者账号诊断/Fetch author diagnosis

POST /api/v1/douyin/creator_v2/fetch_author_diagnosis

获取加密图片解析/Get Sign Image

GET /api/v1/douyin/xingtu/get_sign_image（必填: uri）

根据抖音用户ID获取游客星图kolid/Get XingTu kolid by Douyin User ID

GET /api/v1/douyin/xingtu/get_xingtu_kolid_by_uid（必填: uid）

根据抖音sec_user_id获取游客星图kolid/Get XingTu kolid by Douyin sec_user_id

GET /api/v1/douyin/xingtu/get_xingtu_kolid_by_sec_user_id（必填: sec_user_id）

根据抖音号获取游客星图kolid/Get XingTu kolid by Douyin unique_id

GET /api/v1/douyin/xingtu/get_xingtu_kolid_by_unique_id（必填: unique_id）

获取kol基本信息V1/Get kol Base Info V1

GET /api/v1/douyin/xingtu/kol_base_info_v1（必填: kolId, platformChannel）

获取kol观众画像V1/Get kol Audience Portrait V1

GET /api/v1/douyin/xingtu/kol_audience_portrait_v1（必填: kolId）

获取kol粉丝画像V1/Get kol Fans Portrait V1

GET /api/v1/douyin/xingtu/kol_fans_portrait_v1（必填: kolId）

获取kol服务报价V1/Get kol Service Price V1

GET /api/v1/douyin/xingtu/kol_service_price_v1（必填: kolId, platformChannel）

获取kol数据概览V1/Get kol Data Overview V1

GET /api/v1/douyin/xingtu/kol_data_overview_v1（必填: kolId, _type, _range, flowType）

获取kol视频表现V1/Get kol Video Performance V1

GET /api/v1/douyin/xingtu/kol_video_performance_v1（必填: kolId, onlyAssign）

获取kol转化视频展示V1/Get kol Convert Video Display V1

GET /api/v1/douyin/xingtu/kol_convert_video_display_v1（必填: kolId, detailType, page）

获取kol连接用户V1/Get kol Link Struct V1

GET /api/v1/douyin/xingtu/kol_link_struct_v1（必填: kolId）

获取kol连接用户来源V1/Get kol Touch Distribution V1

GET /api/v1/douyin/xingtu/kol_touch_distribution_v1（必填: kolId）

获取kol内容表现V1/Get kol Rec Videos V1

GET /api/v1/douyin/xingtu/kol_rec_videos_v1（必填: kolId）

获取kol粉丝趋势V1/Get kol Daily Fans V1

GET /api/v1/douyin/xingtu/kol_daily_fans_v1（必填: kolId, startDate, endDate）

获取达人广场筛选字段/Get Author Market Fields

GET /api/v1/douyin/xingtu_v2/get_author_market_fields

获取创作者基本信息/Get Author Base Info

GET /api/v1/douyin/xingtu_v2/get_author_base_info（必填: o_author_id）

获取创作者商业卡片信息/Get Author Business Card Info

GET /api/v1/douyin/xingtu_v2/get_author_business_card_info（必填: o_author_id）

获取创作者位置信息/Get Author Local Info

GET /api/v1/douyin/xingtu_v2/get_author_local_info（必填: o_author_id）

获取创作者视频列表/Get Author Show Items

GET /api/v1/douyin/xingtu_v2/get_author_show_items（必填: o_author_id）

获取创作者评论热词/Get Author Hot Comment Tokens

GET /api/v1/douyin/xingtu_v2/get_author_hot_comment_tokens（必填: author_id）

获取创作者内容热词/Get Author Content Hot Keywords

GET /api/v1/douyin/xingtu_v2/get_author_content_hot_keywords（必填: author_id）

获取相似创作者推荐/Get Recommend Similar Star Authors

POST /api/v1/douyin/xingtu_v2/get_recommend_for_star_authors

获取优秀行业分类列表/Get Excellent Case Category List

GET /api/v1/douyin/xingtu_v2/get_excellent_case_category_list

获取创作者传播价值/Get Author Spread Info

GET /api/v1/douyin/xingtu_v2/get_author_spread_info（必填: o_author_id）

获取用户主页二维码/Get User Profile QRCode

GET /api/v1/douyin/xingtu_v2/get_user_profile_qrcode

获取星图IP日历行业列表/Get IP Activity Industry List

GET /api/v1/douyin/xingtu_v2/get_ip_activity_industry_list

获取星图IP日历活动列表/Get IP Activity List

POST /api/v1/douyin/xingtu_v2/get_ip_activity_list

获取星图IP活动详情/Get IP Activity Detail

GET /api/v1/douyin/xingtu_v2/get_ip_activity_detail（必填: id）

获取营销活动案例/Get Resource List

GET /api/v1/douyin/xingtu_v2/get_resource_list（必填: resource_id）

调用示例

基础调用

curl -X GET "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_hot_search_result" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json"

带参数调用

curl -X GET "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_one_video?aweme_id=123456" \
  -H "x-api-key: $MAXHUB_API_KEY"

POST请求

curl -X POST "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_user_like_videos" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sec_user_id": "xxx"}'

带参数调用

curl -X GET "BASE_URL/API_PATH?param1=value1&param2=value2" \
  -H "x-api-key: $MAXHUB_API_KEY"

POST请求

curl -X POST "BASE_URL/API_PATH" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

注意事项

所有请求必须携带有效的MaxHub API Key
API调用按次计费，注意控制调用次数
遵守平台数据使用规范，不采集敏感个人隐私数据
分页数据建议逐页获取，避免一次性请求过多
高频调用注意限流（默认60次/分钟）

maxhub-douyin

Safety Notice

Copy this and send it to your AI assistant to learn

🎵 抖音（Douyin）Skill

⚠️ 重要提示

环境变量配置（必须）

🔒 安全声明

常见错误及解决方法

错误 1: 401 Unauthorized

错误 2: 402 Payment Required

错误 3: 404 Not Found

错误 4: 429 Too Many Requests

认证方式

API能力全景

🚀 快速开始

首次使用

API 调用格式

认证说明

智能调度规则

1. 意图识别 → API选择

2. 链式调用策略

3. 参数智能填充

⚡ 调用限制

API详细目录

数据采集

互动操作

数据分析

搜索查询

工具服务

内容解析

创作者/达人

调用示例

基础调用

带参数调用

POST请求

带参数调用

POST请求

注意事项

Source Transparency

Related Skills

Chu Hui

AI Era Career Planner

Chou Fei

Edinburgh Scotland