ae_xigua_fetch_user_post_list
获取指定西瓜视频用户发布的作品列表,按页返回。
输入:
- user_id(必填,字符串):要查询的用户 ID。
- max_behot_time(选填,字符串):分页游标。首次请求可省略或传空字符串;获取下一页时,将上一页最后一条作品的 behot_time 值转为字符串传入,文档标注的位置为 $.data.data[-1].behot_time。不要将其当作任意日期筛选条件。
返回:包含该用户当前页作品列表的响应。响应结构未具体约定每条作品的字段;单次请求不保证返回全部作品。
首页示例:user_id="1922379661976311",max_behot_time=""。
ae_xigua_fetch_video_comment_list
按页获取指定西瓜视频的评论列表。
输入参数:
- item_id(必填,字符串):视频作品 ID。
- offset(可选,整数,默认 0):首次请求使用 0;后续请求使用上一次响应返回的 offset。
- count(可选,整数,默认 20):希望获取的评论数量,建议保持默认值。
返回含义:响应包含指定视频当前请求页的评论列表数据。单条评论的具体字段未作明确约定。
输入示例:{"item_id":"7354954305222377999","offset":0,"count":20}
ae_xigua_fetch_video_data
根据作品 ID 获取单个西瓜视频作品的有限数据。
输入:必填参数 item_id,类型为字符串,表示作品 ID,例如 "7354954305222377999"。
返回:作品相关数据,其中包含 Base64 编码的播放地址,使用前需要解码。结果不包含标题等完整作品信息,也不是视频文件下载。响应数据可能为空,具体数据字段结构未作固定定义。
ae_xigua_fetch_video_play_url
获取单个西瓜视频作品的播放链接。
输入:item_id(必填,字符串),表示作品 ID。例如:"7354954305222377999"。
返回:已解码的明文视频播放链接,可直接使用,无需再次解码。返回的是链接,而非视频文件。
ae_toutiao_get_article_info
获取指定头条文章的信息。
输入:aweme_id 为必填字符串,填写文章 ID,而非完整链接。例如,文章链接为 https://www.toutiao.com/article/7450114952884503059/ 时,填写 "7450114952884503059"。
返回:响应中的 data 表示该文章的信息,也可能为 null;文档未定义具体的文章字段。本工具用于查询一篇已知文章,不用于搜索文章。
ae_toutiao_get_comments
分页获取指定今日头条作品的评论。
输入参数(均为必填字符串):
- group_id:作品 ID,可从作品链接中提取。例如,https://www.toutiao.com/i7453372680222523931/ 对应的作品 ID 为 "7453372680222523931"。
- offset:分页偏移量。首页请显式传入 "0",后续页依次使用 "20"、"40" 等,每次增加 20;不可省略此参数。
返回含义:返回指定作品在所请求偏移量处的评论列表数据。已公开的响应结构未定义各条评论的具体字段。
调用示例:{"group_id":"7453372680222523931","offset":"0"}。
ae_toutiao_get_user_id
从头条用户主页链接获取对应的用户 ID。
输入:user_profile_url(必填,字符串)——目标用户的头条主页链接,例如以 https://www.toutiao.com/c/user/token/ 开头的用户主页链接。
返回:包含该主页对应用户 ID(user_id)的响应;具体 ID 数据结构未作定义。本工具用于将主页链接解析为用户 ID,不用于按昵称搜索用户或获取完整用户资料。
ae_toutiao_get_user_info
获取指定今日头条用户的信息。
输入:必填参数 user_id,类型为字符串,填写目标用户的用户 ID,例如 "1352838578180211"。使用前需先获取该用户的 ID。
返回:响应包含 data 中的用户信息及响应状态等元数据。data 可能为空;文档未明确列出用户信息的具体字段。
ae_toutiao_get_video_info
获取指定今日头条视频的作品信息。
输入:必填参数 aweme_id,类型为字符串,表示视频的作品 ID。请从视频链接中提取 ID,不要传入完整链接。例如,https://www.toutiao.com/video/7431543350882206242/ 对应 aweme_id = "7431543350882206242"。
返回:响应中的 data 承载指定视频的作品信息。data 可能为空;已提供的响应定义未明确具体的作品详情字段。本工具用于按已知 ID 查询单个视频,不用于搜索视频或下载视频文件。
ae_douban_get_movie_review_detail
通过评论 ID 获取单条豆瓣影视长评详情。必填参数 reviewId 为字符串,需填写评论的唯一 ID,而非影视条目 ID。适合在剧目评论列表中找到某条长评后进一步查看。返回包含查询数据的 data,以及 code、message 和 recordTime;data 内的具体字段未作定义,不保证包含某一特定评论字段。本工具不用于搜索评论或获取评论列表。
ae_douban_list_movie_comments
获取指定豆瓣电影或电视剧条目的一页观众短评。必须提供条目标识符 subjectId,不能仅用片名代替。可选 page 指定页码,默认 1;sort 可选 time(按时间,默认)或 new_score(按新评分)。返回短评数据及状态信息;具体短评字段和分页元数据未作约定,单页结果不代表全部短评。
ae_douban_list_movie_reviews
获取指定电影或电视剧条目的一页观众长评,适合浏览深度观后评论。需提供条目唯一标识符 subjectId;可选 page 指定页码,默认 1;sort 可选 time(按时间,默认)或 hotest(按热度,须使用此拼写)。返回评论结果数据及状态信息;响应定义未明确单条评论字段或分页统计信息。此工具不用于按片名搜索或获取短评。
ae_douyin_xingtu_check_creator_visibility
查询指定创作者能否在所选内容渠道展示,适合在建立活动候选名单前检查展示可用性。必须通过 oAuthorId 提供创作者唯一 ID;platform 可选,支持 SHORT_VIDEO(短视频,默认值)、LIVE_STREAMING(直播)、PICTURE_TEXT(图文)和 SHORT_DRAMA(短剧)。返回对象包含状态码 code、结果数据 data、消息 message 和 recordTime;data 承载展示可用性结果,其内部结构未明确约定。查询失败不等于创作者不可展示;本工具不修改展示状态,也不确认创作者参与活动。
ae_douyin_xingtu_get_creator_channel_metrics
查询指定抖音创作者在一种内容形式下的渠道信息。需提供创作者唯一 ID(oAuthorId);可选参数 platform 支持 SHORT_VIDEO(短视频,默认)、LIVE_STREAMING(直播)、PICTURE_TEXT(图文)和 SHORT_DRAMA(短剧)。每次查询针对一位创作者及一种内容形式,返回结果包含响应码 code、渠道数据 data、消息 message 和记录时间 recordTime。data 的具体字段未作定义,不保证包含特定表现指标,也不应仅凭数据缺失断定该渠道不存在。需要比较不同内容形式的渠道情况时,可分别查询。
ae_douyin_xingtu_get_creator_contract_basics
查询抖音巨量星图创作者的合同相关基础信息,供活动策划时了解创作者的合同背景。必填 oAuthorId(作者唯一 ID);可选 range:DAY_30 表示最近 30 天,DAY_90 表示最近 90 天,未传时的默认周期未明确。返回包含 code、data、message 和 recordTime 的响应,其中 data 承载合同相关信息,但其具体字段未明确。本工具仅用于查询,不创建或修改合同。
ae_douyin_xingtu_get_creator_side_basics
查询指定创作者在抖音巨量星图中的侧边栏基础信息,便于在入围筛选时了解其市场概况。需通过字符串参数 oAuthorId 提供创作者的唯一 ID。返回内容包含创作者数据、状态码、消息和记录时间;创作者数据内部未定义固定字段,具体可用信息以实际响应为准,并应结合状态码和消息判断查询结果。