ae_douyin_fetch_user_series_list
## 用途
分页获取指定抖音用户发布的短剧合集列表。
## 输入条件
- `user_id`:用户 ID,与 `sec_user_id` 二选一提供即可。
- `sec_user_id`:用户加密 ID,可代替 `user_id` 标识目标用户。
- `cursor`:整数类型的分页游标,默认值为 `0`,用于获取第一页;获取下一页时,使用上一次响应返回的 `cursor`。
## 返回含义
返回所请求页面的用户短剧合集列表数据。响应中的 `series_id` 可用于后续查询短剧详情和视频列表。本工具仅列出合集,不直接获取合集的完整详情或视频;浏览全部合集可能需要多次分页请求。
ae_douyin_fetch_video_channel_result
获取指定抖音频道的视频频道数据。
输入参数:
- tag_id(必填,整数):从频道链接中提取的频道标签 ID。例如,https://www.douyin.com/channel/300205 对应 300205;应传入数字 ID,而非完整链接。
- count(可选,整数,默认 10):请求获取的条目数量。
- refresh_index(可选,整数,默认 1):刷新索引。其与分页的对应关系未明确说明。
返回结果:JSON 响应,data 字段承载频道数据,并附带响应状态和元信息。data 可能为空,其内部字段结构未明确规定。
示例:tag_id=300205,count=10,refresh_index=1。
ae_douyin_generate_short_url
为抖音链接生成短链接。
输入:`url` 为必填字符串,填写需要生成短链接的抖音链接。
返回:JSON 响应,包含状态信息,以及 `data` 中的短链接结果数据。`data` 的具体结构未明确规定,且可能为空,因此不应将整个返回值直接视为短链接字符串。
ae_douyin_generate_video_share_qrcode
为抖音视频生成分享二维码。
输入:object_id 为必填字符串,填写视频作品 ID,例如 "7348044435755846962"。
返回:包含二维码数据及状态、提示信息的响应。二维码数据的具体结构和编码格式未明确,不保证直接返回可展示的图片或图片链接。
ae_douyin_index_fetch_all_area
获取抖音指数支持的全部地区列表。
输入:无需参数,使用空对象({})调用。
返回含义:响应数据为省份与城市的层级列表,可用于选择关键词指数查询的地区筛选条件。本工具仅查询支持的地区,不返回关键词指数数值或地区表现统计。已提供的响应结构未定义单个地区条目的具体字段。
ae_douyin_index_fetch_brand_hot_videos_time_scope
获取品牌热门视频功能可查询的时间范围,帮助你在查询视频数据前选择受支持的日期。
输入:无需参数,传入空对象即可。
返回:可查询时间范围信息,例如可用起止日期和周期单位。具体数据字段及日期格式未明确规定。本工具不返回视频列表,也不用于确定其他无关功能的可查询时间范围。
ae_douyin_index_fetch_brand_initiative_rank_weekly
查询指定品牌在抖音或头条的品牌主动排行周榜数据。
输入:
- brand_name(必填):品牌名称。
- start_date、end_date(必填):查询开始日期和结束日期,均为 YYYYMMDD 格式的字符串。
- app_name(选填):aweme 表示抖音(默认),toutiao 表示头条。
返回:包含状态信息及周榜数据载荷的响应,数据用于反映指定品牌在所选日期范围和平台的品牌主动排行周榜情况。具体数据字段和排行指标定义未作说明。
ae_douyin_index_fetch_content_author_portrait
获取抖音指定内容垂类下发布视频的创作者群体画像。统计对象是创作者,不是观看视频的受众,也不是单个账号的个人资料。
输入条件:
- tag_id(必填,字符串):具体垂类 ID,不支持用 "0" 表示全部垂类;请从垂类筛选选项中选择非零 ID。
- end_date(必填,字符串):统计结束日期,格式为 YYYYMMDD。
- period(可选):"week" 表示按周,"month" 表示按月,默认 "month"。按周时 end_date 必须为周日;按月时必须为当月最后一天。
返回创作者画像分布,例如性别、年龄段、地域、设备和活跃时段。具体画像字段以实际返回的数据为准;数据载荷可能为 null,未约定固定的画像字段结构。
示例:tag_id="601",period="month",end_date="20260331"。
ae_douyin_index_fetch_content_consume_trend
查询抖音指定内容垂类在一段时间内的每日消费趋势,用于了解该垂类内容被实际观看的热度变化。这里的“消费”指内容观看,不是金额支出。
必填输入:
- tag_id:具体垂类 ID,字符串;不支持使用 "0" 查询全部垂类。
- start_date:开始日期,YYYYMMDD 格式的字符串,包含当日。
- end_date:结束日期,YYYYMMDD 格式的字符串,包含当日。
返回按日聚合的消费数据,文档列举的指标包括每日播放总量、观看时长和独立观看人数。响应定义未固定具体指标字段及数据结构,请以实际返回的数据为准。
ae_douyin_index_fetch_content_creative_duration
## 用途
获取指定内容垂类的视频时长分布,用于了解该垂类的视频时长结构及创作者偏好的视频长度。
## 输入条件
- `tag_id`(必填,字符串):具体垂类 ID,不支持表示全部垂类的 `"0"`。
- `end_date`(必填,字符串):统计结束日期,格式为 `YYYYMMDD`。按周统计时必须为周日,按月统计时必须为当月最后一天。
- `period`(可选):`"week"` 表示按周统计,为默认值;`"month"` 表示按月统计。
## 返回含义
返回各视频时长区间的视频数量与占比。文档中的区间示例包括 0–15 秒、15–60 秒、60–180 秒及大于 180 秒。这些数据是垂类汇总统计,不是单条视频记录。响应结构未固定详细结果字段,应以实际返回的区间标签和数值为准。
ae_douyin_index_fetch_content_creative_keyword_items
获取抖音指定内容垂类下、指定热门关键词的相关视频列表,用于查看哪些视频对该关键词有贡献。
输入与前置条件:
- tag_id(必填):具体垂类 ID,不支持使用 "0" 查询全部垂类。
- keyword(必填):必须先通过 fetch_content_creative_keywords 获取热门关键词列表,再从中选择。此次查询的 tag_id、period、end_date 必须与获取关键词列表时完全一致,否则可能返回 "json data error"。
- period(可选):字符串 "1" 表示近 1 天,"3" 表示近 3 天,"7" 表示近 7 天;默认值为 "7"。
- end_date(必填):YYYYMMDD 格式的结束日期。当 period="7" 时必须为周日;当 period="1" 或 "3" 时可为任意日期。
返回:响应中的 data 包含该关键词相关的视频列表;响应结构未明确每条视频的具体字段。本工具用于热门关键词的视频下钻查询,不是任意关键词搜索。
ae_douyin_index_fetch_content_creative_keywords
获取抖音指定内容垂类在所选周期内的创作热门关键词,辅助选题研究与内容策划。
输入参数:
- tag_id(必填,字符串):具体的内容垂类 ID,例如 "601" 表示剧情、"628" 表示美食。不支持 "0=全部"。
- end_date(必填,字符串):统计结束日期,格式为 YYYYMMDD。period="7" 时必须为周日;period="1" 或 "3" 时可为任意日期。
- period(可选,字符串):"1" 表示近 1 天,"3" 表示近 3 天,"7" 表示近 7 天。默认值为 "7",因此省略此参数时,结束日期也必须为周日。
返回所选垂类和周期内的热门关键词列表;单条关键词的具体字段未作定义。
示例:tag_id="601",period="7",end_date="20260412"。
ae_douyin_index_fetch_content_interact_trend
获取抖音指定内容垂类在给定日期区间内的每日互动趋势,用于了解用户互动活跃程度的变化。
输入(均为必填字符串):
- tag_id:具体垂类 ID,不支持使用 "0" 查询全部垂类。
- start_date:开始日期,格式为 YYYYMMDD,包含当天。
- end_date:结束日期,格式为 YYYYMMDD,包含当天。
返回按日聚合的互动数据,例如每日点赞、评论、分享、收藏总数。具体响应结构未作细化定义,可用指标以实际返回数据为准。结果反映垂类整体趋势,而非单条内容的互动明细。
ae_douyin_index_fetch_content_valid_date
获取抖音指数创作指南各类型数据的可查询日期范围。
- 输入:无需任何参数。
- 返回:创作指南数据可查询的起止日期,用于了解可选的查询时间范围。响应定义未明确日期范围数据的具体格式。
- 适用场景:查询创作指南数据前,先确认所需日期是否在可查询范围内;本工具不返回具体内容或指标数据。
ae_douyin_index_fetch_encrypt_user_id
将抖音 uid 转换为抖音指数使用的加密 user_id。
输入:uid 为必填项,必须是纯数字字符串,例如 "3100268042915212"。
返回:uid 表示原始输入的抖音用户标识;user_id 表示对应的加密用户标识。
适用于调试或需要直接获取加密标识的场景。达人相关操作已自动完成此转换,通常无需单独调用本工具。
ae_douyin_index_fetch_insight_get_rec
根据当前查看的报告,获取相关推荐的其他洞察报告。
输入:report_id(必填,字符串),即当前报告的 ID,可从报告搜索或报告推荐结果中获取。例如:"1081"。
返回:相关推荐报告数据,文档描述为报告列表,包含报告 ID、标题、封面、发布时间等信息;具体数据结构及字段是否齐全未作明确约定。适合用于发现相关报告或展示报告详情页的“相关推荐”模块,不用于获取当前报告的完整正文。