ae_douyin_fetch_one_video_danmaku
获取单个抖音视频的弹幕数据,即播放时显示在画面上的评论,不是普通评论区数据。
必填输入:
- item_id(字符串):视频作品 ID。
- duration(整数):视频总时长。
- start_time(整数):需要获取弹幕的开始时间。
- end_time(整数):需要获取弹幕的结束时间。
返回包含视频弹幕数据的响应,其中 data 为业务数据,另附响应状态和元数据。文档未规定单条弹幕记录的具体字段结构。
文档未明确时间参数的单位,准备输入前应确认单位,不要自行假定为秒或毫秒。
文档输入示例:item_id="7355433624046472498",duration=15134,start_time=0,end_time=15133。
ae_douyin_fetch_video_danmaku_list
获取指定抖音作品的弹幕列表,支持分页、排序及正常/被屏蔽弹幕筛选。
输入参数:
- item_id(必填,字符串):作品 ID,可从作品链接或其他查询结果中获取;应传入 ID,而非完整链接。
- count(可选,整数):每页请求数量,范围 1–100,默认 20。
- offset(可选,整数):分页起始偏移量,不小于 0,默认 0。
- order_type(可选,整数):默认 1;1 表示时间排序,2 仅被定义为“其他排序”,具体规则未说明。
- is_blocked(可选,布尔值):默认 false,获取正常弹幕;true 表示获取被屏蔽的弹幕。
返回含作品弹幕列表数据的响应对象,业务数据位于 data 中,也可能为 null。单条弹幕字段及分页结果字段未明确规定。本工具仅查询数据,不会屏蔽、取消屏蔽或删除弹幕。
ae_douyin_fetch_video_mix_detail
查询指定抖音视频合集的详情。
输入:
- mix_id(必填,字符串):要查询的合集 ID,例如 "7302011174286002217"。请使用合集 ID,而非单条视频 ID。
返回:
- 响应中的 data 字段承载合集详情数据。data 可能为空,详情数据的具体字段未作规定。
适用于已知合集 ID、需要查看该合集详情的场景,不用于搜索合集。
ae_douyin_fetch_video_mix_post_list
获取指定抖音视频合集中的作品列表,支持按游标翻页。
输入参数:
- mix_id(必填,字符串):合集 ID。
- cursor(可选,整数,默认 0):首页使用 0;后续页使用上一次响应返回的 cursor 值,不是页码。
- count(可选,整数,默认 20):请求的作品数量。请保持默认值 20,修改可能导致错误。
返回含义:返回指定合集对应页的视频作品列表数据;单条作品的具体字段未作明确约定。
示例:mix_id="7302011174286002217",cursor=0,count=20。
ae_douyin_index_fetch_brand_radar_chart
获取品牌在抖音或头条指定日期范围内的多维度评分数据,用于雷达图展示。
输入:
- brand_name(必填):品牌名称。
- start_date、end_date(必填):开始日期和结束日期,均使用 YYYYMMDD 格式。
- app_name(可选):aweme 表示抖音,toutiao 表示头条;默认值为 aweme。
返回:所选平台及时间范围内的品牌雷达图评分数据,而非已渲染的图表图片。现有响应说明未定义具体评分维度、分值尺度或数据的详细结构,需以实际返回内容为准。
ae_douyin_index_fetch_topic_suggest
获取抖音或头条话题搜索的自动补全建议。
输入:
- keyword(必填,字符串):用于匹配话题的关键词。
- app_name(可选):aweme 表示抖音,toutiao 表示头条;默认 aweme。
返回:响应中的 data 为匹配的话题建议,用于补全或细化搜索词。文档未规定单条建议的具体字段;这些结果是搜索建议,并非话题分析数据或完整话题详情。
ae_douyin_xingtu_get_author_content_hot_keywords
获取指定抖音创作者的内容热词。
输入:
- author_id(必填,字符串):创作者 ID。
- keyword_type(可选,整数):热词类型,默认值为 0。现有文档未说明各类型取值及其含义。
返回:响应的 data 字段承载该创作者的内容热词数据,可能为 null。现有文档未定义热词数据的详细结构,不能预设结果包含词频、排名或特定时间范围。
输入示例:{"author_id":"7589271892177518598","keyword_type":0}
ae_douyin_xingtu_get_author_spread_info
## 用途
查询抖音星图创作者的传播价值信息,为评估其商业传播能力提供参考。
## 输入参数
- **o_author_id**(必填,字符串):创作者 ID。
- **range**(可选,整数,默认 `2`):`2` 表示近 30 天,`3` 表示近 90 天。
- **type**(可选,整数,默认 `1`):视频类型;`1` 表示个人视频。
- **only_assign**(可选,布尔值,默认 `false`):设为 `true` 时仅查看指派视频。
- **flow_type**(可选,整数,默认 `0`):流量类型。
- **platform_source**(可选,整数,默认 `1`):平台来源。
- **platform_channel**(可选,整数,默认 `1`):平台渠道。
平台来源、平台渠道、视频类型及流量类型的其他取值含义未提供说明。
## 返回含义
响应中的 `data` 承载该创作者的传播价值数据,同时包含响应状态及相关元信息。`data` 可能为空;具体指标字段及其定义未明确列出,请以实际返回内容为准,不应预设特定评分或指标。
## 示例
`{"o_author_id":"7589271892177518598","range":2}` 表示查询指定创作者近 30 天的传播价值信息,其余参数使用默认值。
ae_douyin_xingtu_get_author_video_distribution
## 用途
获取指定抖音创作者的视频内容分布,帮助了解其主要内容方向与视频构成。
## 输入
- `o_author_id`(必填,字符串):创作者 ID。
- `platform_source`(可选,整数):平台来源,默认 `1`,表示抖音。
- `platform_channel`(可选,整数):平台渠道,默认 `1`,表示短视频。
其他平台来源或平台渠道取值暂无文档说明。
## 返回
响应数据包含该创作者的视频内容分布。具体分布字段未明确说明,数据也可能为空(null);请根据实际返回的信息解读内容构成。
ae_douyin_xingtu_get_item_report_th_analysis
获取单个抖音视频的互动分析数据。
输入:必须提供 request_body 对象,其中 item_id 为字符串类型的视频 ID。
返回:响应中的 data 字段承载该视频的互动分析数据,也可能为 null;响应还包含状态等元信息。分析数据的具体字段未作固定定义,请以实际返回内容为准。
输入示例:
{"request_body":{"item_id":"7451907165419359488"}}
ae_douyin_xingtu_get_playlet_actor_rank_catalog
获取短剧演员热榜的分类目录,用于了解热榜有哪些分类。
输入:无需任何参数,使用空对象({})调用;不支持传入演员标识或分类筛选条件。
返回:JSON 响应,其中 data 为热榜分类数据,并附有响应状态及元数据。分类条目的具体结构未明确说明,data 可能为 null。返回的是分类目录,而非演员排名明细。
ae_douyin_xingtu_get_recommend_for_star_authors
根据参考创作者 ID,获取抖音星图的相似创作者推荐。
输入:
- request_body(必填):包含查询条件的对象。
- request_body.author_ids(必填):创作者 ID 数组,每个 ID 均为字符串。
- request_body.similar_type(可选,默认 "content"):相似维度。文档列出的取值为 "comprehension"(综合相似)、"content"(内容相似)、"audience"(受众相似)和 "commercial"(商业能力相似)。
- request_body.page(可选,默认 1):整数页码。
返回:响应的 data 字段承载相似创作者推荐数据。该字段可能为 null;文档未定义推荐条目的具体字段结构。
输入示例:
{"request_body":{"author_ids":["7589271892177518598"],"similar_type":"content","page":1}}
ae_douyin_xingtu_kol_cp_info_v1
获取指定抖音星图达人的 V1 性价比能力分析。输入:必填参数 kolId,类型为字符串,值为该达人的星图 KOL 标识,例如 "7048929565493690398"。若仅有抖音 uid、sec_user_id 或 unique_id,需先查询对应的星图 kolId,不应将这些标识直接作为 kolId 使用。返回:响应中的 data 为可用的达人性价比分析数据,也可能为空;文档未规定具体分析指标,应以实际返回字段为准。
ae_douyin_xingtu_kol_daily_fans_v1
查询抖音星图达人在指定日期范围内的每日粉丝趋势。
必填输入:
- kolId:达人的星图 KOL 标识。如果只有 UID、sec_user_id 或 unique_id,需先将其转换为 kolId,不能直接替代。
- startDate:开始日期,字符串格式为 yyyy-MM-dd。
- endDate:结束日期,字符串格式为 yyyy-MM-dd。
返回该达人在指定时段内的粉丝趋势数据,用于查看粉丝随时间的变化。具体数据字段未明确规定;本工具不用于查询粉丝名单。
示例:kolId="7048929565493690398",startDate="2024-12-01",endDate="2025-01-01"。
ae_tiktok_fetch_home_feed
获取首页推荐作品。可设置返回数量(默认 15)和地区代码(默认 US),也可以提供用户自己的 Cookie 以获得个性化推荐。返回结果包含推荐 feed 数据,可能包括视频链接;访问直接视频 CDN 链接时,可能需要将返回的 `tt_chain_token` 作为 Cookie 携带。
ae_tiktok_fetch_post_ai_article
### 用途
根据视频作品 ID 获取该作品可用的 AI 生成内容,包括标题、内容概览、关键词和长文正文,可用于内容分析、选题参考和 SEO 关键词整理。
### 输入参数
- `itemId`:必填,视频作品 ID,类型为字符串。
### 返回内容
如果结果包含 `itemCustomTDK`,其中可能有:
- `title`:AI 生成的标题
- `desc`:内容概览或摘要
- `keywords`:AI 提取的关键词列表
- `article`:根据视频内容生成的长文正文
### 注意事项
- 并非每个作品都有 AI 生成内容;没有可用内容时,结果中可能没有 `itemCustomTDK` 字段。
- 部分作品只有标题、概览和关键词,`article` 可能为空字符串。
- 长文使用的语言由视频作品本身决定,不受请求参数影响。