ae_douyin_search_douplus_user
## 用途
在 DOU+ 投放场景下,按抖音号/ID 或昵称搜索抖音用户,支持游标翻页。
## 输入
必须提供 `request_body` 对象,其中包含:
- `keyword`(必填,字符串):要搜索的抖音号/ID 或昵称。
- `count`(可选,整数或 null):每页数量,默认 20。
- `cursor`(可选,整数或 null):翻页游标,默认 0。首页使用 0,后续页使用上一页响应返回的 cursor。
## 返回
返回匹配的用户及相关信息,例如昵称、抖音号、`sec_uid`、粉丝数等,并提供翻页信息。返回的 `cursor` 用于请求下一页,`has_more` 表示是否还有更多结果。响应模式未固定用户记录的具体结构。
本工具仅搜索用户,不创建或提交投放计划。
ae_douyin_fetch_hot_search_result
获取抖音热榜数据,用于查看热门话题。无需输入参数,使用空对象调用即可。返回结果中的 data 字段承载热榜数据,也可能为 null,并附带响应状态及相关元信息;热榜条目的具体字段未作约定。不支持关键词搜索或按日期筛选。
ae_douyin_index_fetch_item_base
获取指定视频在抖音指数「视频分析」中的基础详情。
输入:必填 item_id,即视频的抖音 aweme ID,须以纯数字字符串提供,例如 "7660090930283744575"。
返回:响应中的 data 按文档说明包含视频标题、封面、时长、发布时间、作者信息及基础数据等。响应结构未固定 data 的具体字段,且 data 可能为空,应以实际返回内容为准。本工具用于查询已知视频 ID 的详情,不用于搜索视频。
ae_x_get_trending
获取 X(Twitter)指定国家的趋势数据。
输入:
- country(可选字符串):国家标识,省略时默认为 UnitedStates。请使用文档中的拼写,例如 UnitedStates(美国)、UnitedKingdom(英国)、Japan(日本)、India(印度)、China(中国)或 Germany(德国)。
- 不提供日期、分页或返回条数控制参数。
返回:
- 响应中的 data 表示该国家的趋势数据,并附带状态及响应元信息。趋势数据的具体结构未作固定定义,data 也可能为空值;不保证包含排名、帖子数量等特定字段。
示例:{"country":"UnitedStates"}
ae_kuaishou_web_video_data_by_url
通过url查询快手单个视频作品的数据,支持作品链接或分享短链接。视频列表可位于data.photos,具体字段以实际返回为准。不支持图片帖子。
ae_instagram_search_hashtags
根据词语或短语搜索相关的 Instagram 话题标签。
输入:
- `keyword`(必填,字符串):要搜索的关键词,例如 `cat`。
返回:
- `data.items`:匹配的话题标签列表;其中可包含标签名称和帖子数量等信息。
ae_x_twitter_getusersfollowers
根据用户ID分页查询粉丝列表,每次返回一页。每页数量可能变化,使用返回的分页标记继续查询。
ae_douyin_index_fetch_daren_great_user_fans_info
获取指定抖音达人的粉丝分析数据,了解受众画像与活跃规律。
输入:必填参数 user_id,为达人的纯数字抖音 UID,须以字符串传入,例如 "3100268042915212"。
返回:响应数据中的粉丝分析信息,例如粉丝性别分布、年龄分布、地域分布和活跃时间。详细结果结构未作固定定义,具体字段及单位以实际返回为准。本工具用于受众分析,而非获取逐个粉丝的明细记录。
ae_douyin_index_fetch_multi_keyword_interpretation
获取抖音或头条在指定日期范围内的多个关键词指数解读,包括综合指数、搜索指数和内容指数解读。
输入:
- keyword_list(必填):关键词列表,以一个逗号分隔的字符串传入。
- start_date、end_date(必填):开始日期和结束日期,均使用 YYYYMMDD 格式。
- app_name(可选):aweme 表示抖音(默认),toutiao 表示头条。
- region(可选):地区列表,以逗号分隔;留空或不传表示全国。
返回:所选条件下的关键词指数解读数据。响应中的 data 未定义固定的内部结构,具体内容以实际返回为准;指数解读不应直接视为原始搜索次数或内容数量。
ae_douyin_web_encrypt_uid_to_sec_user_id
将抖音用户 uid 转换为加密标识 sec_user_id。
输入:uid 为必填字符串,文档称其为用户 uid(short_id),例如 "1673937488185292"。
返回:JSON 响应,包含状态、消息等元数据,以及承载用户信息的 data。文档未定义 data 的具体结构或 sec_user_id 的字段路径,不应将整个响应直接视为标识字符串。
ae_wechat_get_article_stats
## 用途
通过微信公众号文章链接,获取文章阅读量及互动计数。
## 输入
- `request_body`(必填):包含文章链接及可选返回模式的对象。
- `request_body.url`(必填):`mp.weixin.qq.com` 域名下的公众号文章链接,例如 `https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw`。支持短链及带 `__biz` 的文章长链,但必须匹配 `^https?://mp\.weixin\.qq\.com/s([/?].+)?$`,长度不超过 2048 个字符。
- `request_body.raw`(可选布尔值,默认 `true`):`false` 返回精简计数;`true` 返回完整原始统计对象。
## 返回含义
统计数据位于 `data` 中。`raw=false` 时包含以下七个计数字段:
- `data.read_num`:阅读量。
- `data.like_count`:点赞数。
- `data.old_like_count`:在看数。
- `data.share_count`:分享数。
- `data.collect_count`:收藏数。
- `data.comment_count`:评论数。
- `data.star_num`:星标/喜欢数。
`raw=true` 时包含上述计数,并增加显隐标志(`show_like`、`show_old_like`、`show_share`、`show_collect`、`show_read`、`show_star` 及对应的 `*_gray` 置灰标志)和状态字段(`comment_enabled`、`get_data_succ`、`is_subscribed`、`verify_status`、`can_use_star`)。这些附加字段用于描述显隐或状态,不是额外的互动计数。
结果直接返回,无需轮询任务。响应可能较慢,建议将客户端请求超时设置为 30 秒。本工具获取统计数据,不返回文章正文或具体评论内容。
ae_wechat_get_video_comments
获取微信视频号作品的一级评论,或指定评论下的二级回复,支持游标翻页。
输入均放在 request_body 中:
- object_id(必填):作品的 objectId,纯数字字符串,最长 32 个字符。使用视频列表或视频详情结果中的视频 ID,不是视频链接。
- comment_id(可选):父评论的纯数字 ID 字符串,最长 32 个字符。不传或留空时获取一级评论;传入时获取该评论下的二级回复。
- last_buffer(可选):base64 翻页游标。第一页不传或留空;当返回结果表明还有下一页时,将返回的游标原样传入,并保持相同的作品及父评论上下文。
- raw(可选,默认 true):true 返回原始结构,false 返回精简解析结构。
返回含义:
- raw=false:data.comments 为评论列表,包含评论 ID、评论人昵称/用户名/头像、正文、点赞数、回复数、创建时间及 IP 属地。data.count 为本页评论数,data.down_continue 表示是否有下一页,data.last_buffer 为翻页游标。data.object_id 回显作品 ID;获取回复时 data.comment_id 回显父评论 ID,否则为 null。
- raw=true:data.commentInfo 为评论列表,data.baseResponse.ret 为响应状态码;翻页字段为 data.downContinueFlag 和 data.lastBuffer,后者另有 data.last_buffer 别名。评论字段包括 commentId、nickname、username、content、likeCount、createtime、headUrl 和 ipRegionInfo.regionText。作品全局计数位于 data.monotonicData.commentCount.commentCount 及 data.countInfo。
注意:作品和评论 ID 可能超出 JavaScript 安全整数范围,应以字符串接收和传递,并使用无损 JSON 解析方式,勿经由 JavaScript Number 转换。接口响应可能较慢,请将客户端请求超时设置为 30 秒。
ae_tiktok_get_user_country
# 用途
查询 TikTok 账号关联的国家或地区。
# 输入
- `username`(必填):账号用户名,例如从 `https://www.tiktok.com/@tiktok` 提取 `tiktok`。填写时不带 `@`。
# 返回
返回账号关联的国家或地区,并可能包含可用的账号标识及其他元数据。该信息表示账号关联的国家或地区,不一定代表用户当前所在地或国籍。
ae_youtube_get_general_search
按关键词综合搜索 YouTube,可结合上传时间、视频时长、内容类型和内容特征筛选,并设置排序及语言、地区等选项。
输入:
- search_query(必填):搜索关键词,最多 200 个字符。
- language_code:语言代码,例如 zh-CN 或 en-US;默认 zh-CN。
- country_code:影响结果地区相关性的国家代码,例如 US 或 CN;默认 US。
- time_zone:时区,例如 America/Los_Angeles 或 Asia/Shanghai;默认 America/Los_Angeles。
- upload_time:hour(过去 1 小时)、today(今天)、week(本周)、month(本月)或 year(今年)。
- duration:short(少于 4 分钟)、medium(4–20 分钟)或 long(超过 20 分钟)。
- content_type:video(视频)、channel(频道)、playlist(播放列表)或 movie(电影)。
- feature:live(直播)、4k、hd(高清)、subtitles(字幕)、creative_commons(知识共享许可)、360(360 度视频)、vr180、3d、hdr、location(含位置信息)或 purchased(已购买内容)。
- sort_by:relevance(相关性,文档默认排序)、upload_date(上传日期)、view_count(观看次数)或 rating(评分)。
- continuation_token:可选翻页令牌;如先前搜索结果提供了令牌,可用于请求后续页面。
除 search_query 外均为可选输入。不同筛选项可组合使用,但每个筛选项只能选择一个值,不接受多个值的列表。
返回搜索响应,data 中为 YouTube 原始搜索数据,需要自行解析,并非已整理为统一字段的视频、频道或播放列表记录;不保证具体条目字段。此工具用于搜索内容,不用于下载媒体。
示例:search_query="Python教程"、upload_time="week"、duration="short"、content_type="video",用于搜索本周上传的短时长 Python 教程视频。
ae_xiaohongshu_note_comment_reply_list
获取小红书(RedNote)指定笔记评论下的二级回复列表,支持游标分页,用于查看话题互动、舆情分析或评论管理。首次查询省略分页状态;后续页使用本工具上次返回的游标、搜索或会话状态,不能复用旧供应商的游标。
ae_xiaohongshu_pgy_creator_core_metrics
获取小红书蒲公英创作者的核心数据指标,支持按业务类型(日常笔记/合作笔记)、笔记形式(图文/视频)、统计周期(近30天/近90天)及广告投放筛选,便于进行达人表现分析与对比。参数请放在必填的 request_body 对象中。