ae_tiktok_fetch_general_search
按关键词获取综合内容搜索列表。
输入参数:
- `keyword`(必填):搜索关键词。
- `offset`(可选,默认 `0`):翻页游标。请求下一页时使用上一响应返回的值。
- `search_id`(可选,默认为空):翻页标识。请求下一页时,使用上一响应中的标识;如字段存在,可从 `data.extra.logid` 或 `data.log_pb.impr_id` 获取。
- `cookie`(可选):仅在需要使用用户账号搜索或访问受限时提供用户 Cookie。
返回综合搜索结果数据,其中可包含结果元数据和视频链接。部分返回的视频 CDN 直链可能需要使用响应中提供的令牌信息访问,请遵循响应中的访问说明。
ae_douyin_billboard_fetch_hot_total_high_play_list
## 用途
获取抖音高完播率榜,支持按时间窗口、关键词和内容垂类筛选,并分页查看。
## 输入
所有输入均为可选项,放在 `request_body` 中:
- `page`:整数,页码,默认 `1`。
- `page_size`:整数,每页数量,默认 `10`。
- `date_window`:整数,时间窗口(小时),可选 `1`、`24`、`72`、`168`,分别表示近 1 小时、近 1 天、近 3 天、近 7 天;默认 `24`。
- `keyword`:字符串,按关键词过滤榜单;默认 `""`,表示不按关键词过滤。
- `tags`:内容垂类筛选数组,传 `[]` 表示不按垂类过滤。每项的 `value` 为顶级垂类标签 ID;可选的 `children` 为子级标签对象数组,每个对象使用 `value` 指定子级标签 ID。省略 `children` 表示该顶级垂类下全部子类。标签 ID 应通过内容标签查询获取。
## 示例
```json
{"request_body":{"page":1,"page_size":10,"date_window":24,"keyword":"","tags":[]}}
```
## 返回含义
响应的 `data` 承载所查询的高完播率榜数据,并附带响应状态和元数据。已提供的响应结构未定义榜单条目的具体字段或完播率计算口径;此榜单不等同于播放量榜。
ae_douyin_search_fetch_search_suggest
## 用途
根据输入关键词获取抖音搜索联想词,适合搜索框自动补全、发现相关搜索表达和完善查询词。返回的是搜索词建议,不是视频搜索结果或搜索量统计。
## 输入
- `request_body`(必填对象):包含搜索联想输入。
- `request_body.keyword`(可选字符串):需要联想的关键词,模式默认值为 `人工智能`。建议显式传入目标关键词。
示例:
```json
{"request_body":{"keyword":"人工智能"}}
```
## 返回含义
响应外层包含 `code`(HTTP 状态码)、`message` 和 `data`(结果数据,可能为 null)。文档说明的结果字段包括:
- `status_code`:结果状态,`0` 表示成功。
- `status_msg`:结果信息。
- `sug_list`:搜索建议列表。其中 `content` 为建议搜索词,`pos` 描述匹配字符的位置,`word_record` 包含建议词的位置、文本等元数据。
响应还可能包含请求标识等附加信息。响应模式未固定 `data` 的详细结构,字段是否存在以实际返回为准;请区分外层 `code` 与结果中的 `status_code`。联想词不能直接视为搜索量或热度的证明。
ae_weibo_realtime_search
## 用途
按关键词搜索微博,获取按时间排序的最新微博结果。
## 输入
- `query`(必填,字符串):搜索关键词。
- `page`(可选,整数,默认 `1`):要获取的结果页码。
## 返回
响应数据中包含搜索结果,可包括微博内容、作者信息、图片、视频和互动数据。具体结果结构未被详细定义,各条结果包含的信息可能不同。
## 注意
播放返回的视频时,播放请求需设置请求头 `Referer: https://weibo.com/`。这是视频播放要求,不是额外的搜索输入参数。
## 示例
`{"query":"苹果发布会","page":1}`
ae_youtube_get_video_comments
## 用途
获取指定 YouTube 视频的一页一级评论,支持热门或最新排序,并可通过翻页令牌继续获取。此工具只读取评论,不发布评论,也不直接获取评论下的回复列表。
## 输入参数
- **video_id**(必填,字符串):长度必须为 11 个字符的 YouTube 视频 ID,例如 `oaSNBz4qMQY`。请从视频链接中提取 ID,不要传入完整链接。
- **sort_by**(可选,字符串):`top` 表示热门评论(默认),`newest` 表示最新评论。
- **language_code**(可选,字符串):语言偏好,例如 `zh-CN`、`en-US`、`ja-JP`、`ko-KR`;默认 `zh-CN`。
- **country_code**(可选,字符串):地区代码,例如 `US`、`JP`、`GB`;默认 `US`。
- **continuation_token**(可选,字符串):首次请求时省略;继续获取同一视频的下一页时,传入上次响应返回的评论列表翻页令牌。
- **need_format**(可选,布尔值):`true`(默认)返回清洗后的精简数据;`false` 返回原始数据。
## 返回含义
响应包含 `data` 数据载荷。使用 `need_format=true` 时,文档中的评论数据包含 `comments` 列表,以及可用时返回的列表级 `continuation_token`。单条评论可包含:
- `comment_id`、`content`、`published_time`:评论 ID、正文和相对发布时间。
- `reply_level`:`0` 表示一级评论。
- `like_count`、`reply_count` 及相关展示文本:点赞数、回复数;计数可能以字符串形式返回。
- `author`:作者频道 ID、显示名称、频道链接、头像及认证、创作者或音乐人标记。
- `creator_thumbnail_url`:视频创作者头像链接。
- `reply_continuation_token`:该条评论的回复令牌,不是继续获取一级评论的列表翻页令牌;返回此字段并不表示已获取回复内容。
一次请求只返回一页,不保证覆盖全部评论。原始数据模式的结构与清洗后的评论数据不同。
## 示例
`{"video_id":"oaSNBz4qMQY","sort_by":"newest","need_format":true}`
ae_wechat_get_user_profile
## 用途
获取微信视频号创作者的主页资料及账号级互动统计。
## 输入
传入必填的 `request_body` 对象:
- `username`(必填):视频号 finder username,格式为 `v2_…@finder`,须匹配 `^v2_[0-9a-fA-F]+@finder$`,总长度为 10–256 个字符。可使用视频数据中的 username;若只有 `sph…` 短号,需先转换。不能直接传入昵称或短号。
- `raw`(可选布尔值,默认 `true`):`true` 返回完整的嵌套原始响应;`false` 返回采用 snake_case 字段名的精简拍平资料。
## 返回含义
资料位于 `data` 中。`raw=false` 时,字段包括:
- `username`、`nickname`、`signature`、`head_url`、`region`:账号标识、昵称、签名、头像 URL 和 IP 属地。
- `fans_count`、`feeds_count`、`like_count`、`fav_count`、`forward_count`、`friend_follow_count`:粉丝数、作品数、获赞数、收藏数、转发数和好友关注数。
- `live_duration_hours`:累计直播时长,单位为小时。
- `original_flag`、`collection_count`、`verify_desc`:原创标记、合集数量及认证说明;认证说明可能为 null。
- `linked_accounts`:关联公众号列表,包含 `nickname` 和 `type`。
`raw=true` 时,主页基础资料嵌套于 `data.contact`;统计字段包括 `data.fansCount`、`data.feedsCount`、`data.feedsLikeCount`、`data.feedsFavCount`、`data.feedsForwardCount`。IP 属地位于 `data.ipRegionInfo.regionText`,合集数量位于 `data.collectionListInfo.collectionCount`,关联公众号信息位于 `data.bizInfo.info`。原始响应还包含首屏作品与直播场次信息,但不代表完整作品列表。
## 注意事项
部分账号的粉丝或互动统计会返回 0,不应直接据此认定账号没有受众或互动。本工具用于主页资料查询,不代替认证主体/许可证查询,也不提供合集明细。结果在本次请求中直接返回,无需轮询。响应可能较慢,如可配置客户端请求超时,建议设为 30 秒。
ae_douyin_fetch_multi_video
根据request_body中的1–10个抖音作品ID查询视频或图文作品数据。超过10个ID请分多次调用。删除、私密或不可见作品可能不返回,不保证返回数量等于输入数量。
ae_douyin_index_fetch_topic_query
按关键词搜索抖音或头条话题,查询指定日期范围内的话题详情及相关数据。
输入参数:
- keyword(必填):要搜索的话题关键词。
- start_date(必填):开始日期,使用 YYYYMMDD 格式的字符串。
- end_date(必填):结束日期,使用 YYYYMMDD 格式的字符串。
- app_name(可选):aweme 表示抖音(默认值),toutiao 表示头条。
返回内容:响应状态信息,以及包含话题详情和相关指标的 data 数据,例如话题热度、相关视频数等(如有)。data 可能为空,文档未固定其内部字段结构,具体内容以实际返回为准。
示例:keyword="旅行",start_date="20260406",end_date="20260412",app_name="aweme"。
ae_reddit_post_request
获取指定 Reddit 帖子的主帖内容,包括标题、完整正文及图片、视频等附带多媒体内容。必填参数 reddit_id 为字符串,必须带有 t3_ 前缀。本工具按帖子 ID 查询内容,不用于搜索帖子。提供方未定义响应结构,因此不预设具体返回字段或多媒体内容的呈现形式。
ae_douyin_index_fetch_relation_word
查询指定关键词在抖音或头条、指定日期范围内的关联词分析,包含搜索关联词、内容关联词、关联词排名和关系图谱数据。
输入说明:
- keyword(必填):要分析的关键词。
- start_date(必填):开始日期,使用 YYYYMMDD 格式的字符串,建议选择周一。
- end_date(必填):结束日期,使用 YYYYMMDD 格式的字符串,必须为周日;若不是周日,可能返回空数据。
- app_name(选填):aweme 表示抖音(默认值),toutiao 表示头条。
返回结果用于了解与关键词相关的搜索词、内容词及其排名和图谱关系。详细结果结构未明确,不保证提供特定分数或图谱字段。
示例:keyword="美食",start_date="20260330",end_date="20260405"。
ae_douyin_xingtu_get_kolid_by_uid
通过抖音用户 ID 查询对应的游客星图 KOL 标识(kolid)。必填参数 uid 为字符串,填写抖音用户 ID,例如 "70452002324";可从用户资料查询结果中获取该 ID。响应中的 data 表示 kolid 查询结果,其内部字段结构未明确规定,且可能为 null。本工具用于查询标识对应关系,不用于获取完整用户资料。
ae_douyin_xingtu_multi_get_item_stats
批量获取抖音视频的统计数据与作品详情,每次最多查询20个视频。
输入条件:
- 必须提供 request_body,其中 request_body.item_ids 为视频ID字符串数组;自动去除空项及重复项,超过20个ID会报错。
- request_body.platform_source:可选整数,表示平台来源,默认1。
- request_body.need_cover_url:可选布尔值,控制是否返回封面URL,默认true。
返回含义:
- 返回命中的视频条目,每条包含作品详情与 stats 统计:watch_cnt(播放量)、like_cnt(点赞数)、comment_cnt(评论数)、share_cnt(转发数)、favorite_cnt(收藏数)、interact_rate(互动率)、avg_watch_dura(人均观看时长)。
- watch_cnt 是包含投流、广告加热的总播放量,不能当作纯自然播放量。
- 无效或已删除的视频ID可能被忽略,因此返回条目数可能少于请求数量。
ae_youtube_get_channel_description
获取 YouTube 频道的介绍、资料和频道统计信息。
### 输入条件
- 首次请求提供 `channel_id`;后续请求提供首次响应中的 `continuation_token`。二者需提供其中一个。
- `channel_id` 通常是以 `UC` 开头的 24 位字符串。如果只有频道 URL,请先将其解析为频道 ID,不要直接将 URL 填入此参数。
- `need_format`:可选,默认 `true`,返回清洗后的精简数据;设为 `false` 返回原始数据。
- `language_code`:可选,默认 `zh-CN`,指定显示语言偏好,例如 `en-US`、`ja-JP`。
- `country_code`:可选,默认 `US`,指定地区代码,例如 `US`、`JP`、`GB`。
### 返回含义与两次请求流程
1. 使用 `channel_id` 获取频道名称、账号标识、描述、订阅数、视频数、头像、横幅、频道网址等基本信息,以及 `continuation_token`。
2. 将返回的 `continuation_token` 用于第二次请求,获取注册时间、社交链接、国家和总观看次数等补充信息。
获取完整频道资料需要两次请求,本工具不会自动合并结果。清洗结果中的 `subscriber_count`、`video_count`、`view_count` 等可能是带单位的显示文本,而非数值;日期也可能是本地化文本。部分字段可能为 null 或空值:例如首次响应可能没有注册时间和社交链接,第二次响应可能没有名称、头像或横幅。合并时应保留两次结果中已有的有效信息,不要用空值覆盖。`continuation_token` 用于获取补充频道资料,不是后台任务标识。
ae_weibo_hot_search_summary
获取微博完整热搜榜单(文档说明为50条),用于查看热门话题及其热度排名。
输入:无需参数,使用空对象({})调用。
返回:响应数据中的热搜榜单,包含各话题的排名、关键词、标签(如热点、沸点、官宣、新)和热度值。rank 为 0 表示置顶内容。
注意:这是完整榜单,而非仅前10条的概览;不提供日期选择或筛选参数。频繁查询时,建议缓存结果5–10分钟。
ae_weibo_pic_search
按关键词搜索微博图片内容,同一条微博的多张图片按微博 ID 聚合展示。
输入:
- query(必填,字符串):搜索关键词。
- page(可选,整数,默认 1):要获取的搜索结果页码。
返回图片搜索结果,包含微博 ID、缩略图、原图链接、作者信息和图片数量。缩略图链接会自动转换为原图链接。
示例:query = "yu7",page = 1。
ae_wechat_channels_search_accounts
按关键词搜索微信视频号账号相关记录,用于发现创作者账号及相关频道对象。仅需提供必填的字符串参数 keyword,无需分页输入。返回包含搜索数据 data、结果代码 code、消息 message 和 recordTime;data 内部结构及具体记录字段未作约定,message 和 recordTime 可能为空。请结合结果代码和消息判断查询结果。