ae_xingtu_search_toutiao_creator
## 用途
按创作者昵称、头条号或内容关键词搜索今日头条图文创作者,用于发现和筛选潜在合作达人。
## 输入条件
- **必填:**`keyword`,搜索关键词。
- **分页与排序:**`page` 默认 `1`;`sort_field` 默认 `score`(综合排序);`sort_type` 为 `1` 时升序、`2` 时降序,默认 `2`。
- **合作条件:**`task_category` 为合作对象,默认 `11`;`marketing_target` 为营销目标,默认 `1`;`first_industry_id` 为适配行业 ID;`author_list_id` 为主题推荐达人清单 ID。
- **达人属性:**`tag` 为达人类型 ID,多个 ID 用逗号分隔。`persona_tags` 为人设、学历、认证或调性 ID,逗号表示满足任一,分号分组表示每组都须满足,例如 `1129,110401;110213`。`gender` 为达人性别,`1` 表示男、`2` 表示女;`fans_min`、`fans_max` 为粉丝数下限和上限。
- **图文报价:**`price_min`、`price_max` 为非负整数报价边界;提供任一边界时,必须同时传入 `price_type=11`。`price_type` 仅与报价边界配合使用。
- **效果指标:**`expected_play_min`、`expected_play_max` 在此图文搜索场景中用于预期阅读量筛选;`cpm_min`、`cpm_max` 和 `cpe_min`、`cpe_max` 用于预期 CPM、CPE 筛选。`interact_rate_min`、`interact_rate_max` 为互动率范围,`play_over_rate_min`、`play_over_rate_max` 为完播率范围,`burst_text_rate_min`、`burst_text_rate_max` 为爆文率范围。比率均使用 `0–1` 小数,如 `0.02` 表示 2%。
- **高级画像:**`extra_filter` 必须是 JSON 数组字符串,而不是直接传数组;支持内容主题、观众/粉丝画像、地域等维度。每项必须包含非空字符串 `field_name` 和 `field_value`,可选 `rel_id`。如字段值需要编码数组,也应将数组序列化为字符串。请使用有效的类型/人设 ID、画像字段名与编码,不要直接以任意中文标签代替。
输入示例:
```json
{
"keyword": "数码",
"page": 1,
"gender": 2,
"fans_min": 10000,
"extra_filter": "[{\"field_name\":\"watcher_gender_female_rate_v2__ge\",\"field_value\":\"0.6\"}]"
}
```
## 返回含义
直接返回搜索响应,`data` 为创作者搜索结果,可包含创作者信息、图文报价、粉丝数及预期阅读量等。结果条目的具体结构未固定定义,各项指标不保证全部存在。报价和预期效果仅供筛选参考,不代表合作效果承诺。
ae_tiktok_ads_get_ad_keyframe_analysis
分析广告视频在不同时间点的观众留存情况。必填参数:request_body.material_id,广告素材 ID。可选参数:request_body.metric,默认为 retain_ctr,也可使用 retain_cvr、click_cnt、convert_cnt 或 play_retain_cnt;request_body.cookie 可用于提供自定义 Cookie。返回关键帧分析结果,包括时间点、对应留存率、流失率较高的时间点和观众兴趣较高的时间点。
ae_tiktok_ads_get_top_contents_item_detail
获取热门视频榜单中单个视频的详细数据,帮助分析视频表现、作者资料及受欢迎原因。
### 输入参数
- `item_id`:视频 ID,通常从热门视频榜单条目的 `itemInfo.itemID` 获取。
- `period_end_timestamp`:必填,目标榜单周期结束时间的 10 位 Unix 秒级时间戳。不要传 `0`,否则可能返回空结果;如果视频来自某次榜单查询,请沿用该查询使用的时间戳。
- `period_dimension`:可选榜单周期,支持 `1`、`3` 或 `5`,默认值为 `3`。取 `1` 时应传周日 00:00 UTC 的时间戳;取 `3` 或 `5` 时可传任意已过去日期的时间戳。
- `country_code`:可选国家/地区代码,默认值为 `US`。建议与视频所属榜单查询使用相同的代码。
- `cookie`:可选的自定义 Cookie 字符串。
### 返回内容
成功响应的 `data` 中包含视频详情,核心对象为 `entityInfo`:
- `itemInfo`:视频 ID、标题、创建时间、封面与视频地址、作者/创作者 ID 等基础信息。
- `itemMetrics`:视频播放量、互动率、六秒观看率及相应的累计指标。
- `itemAuthorInfo`、`itemAuthorMetrics`:作者资料及粉丝数等指标。
- `contentTags`:内容分类标签。
- `commentInfos`:热门评论,包括评论文本、点赞数、创建时间和用户信息。
ae_tiktok_fetch_search_live
按关键词搜索直播。
- `keyword`(必填):搜索关键词。
- `count`:每页返回数量,默认为 20。
- `offset`:分页游标,首次请求使用 0。
- `search_id`:用于继续分页的标识。首次请求留空;后续请求与新的 `offset` 一起使用上一次响应中返回的值。
- `cookie`:可选的用户 Cookie,仅在必要时提供。
返回结果的 `data` 字段包含匹配的直播搜索结果,具体字段以实际返回的数据为准。
ae_tiktok_get_multiple_videos
根据作品 ID 批量获取多个 TikTok 视频或图文作品的信息。请将 `request_body` 设为包含 1–10 个字符串 ID 的数组。响应包含所请求作品的数据,具体字段取决于返回内容。
ae_weibo_user_search
## 用途
按关键词或高级筛选条件搜索微博用户账号。
## 输入
所有参数均为可选。
- `query`:搜索关键词。提供时使用“全部”搜索模式;不提供时仅应用高级筛选条件。
- `page`:整数页码,默认为 `1`。
- `region`:地区编码,而非地区名称,例如 `custom:11:1`。
- `auth`:账号认证类型:`org_vip`(机构认证)、`per_vip`(个人认证)、`ord`(普通账号)。
- `gender`:`man` 或 `women`。
- `age`:年龄段编码:`18y`、`22y`、`29y`、`39y` 或 `40y`。
- `nickname`、`tag`、`school`、`work`:分别按昵称、标签、学校、公司筛选。
## 返回与限制
响应数据包含匹配的用户列表,文档说明其内容包括用户 ID(`uid`)、昵称、头像、粉丝数和主页链接。响应结构未对单条用户记录作固定字段约束。筛选条件过多或过严可能没有匹配结果。本工具搜索用户,而非微博帖子。
## 示例
`{"query":"yu7","page":1}`
ae_weibo_video_search
### 用途
按关键词搜索视频内容并浏览匹配结果。
### 输入
- `query`(必填):搜索关键词。
- `mode`(可选,默认 `hot`):结果模式。`hot` 表示热门结果,`all` 表示全部结果。
- `page`(可选,默认 `1`):结果页码。
### 返回
同步返回匹配的视频列表及可用元数据,例如微博标识、作者、内容、视频链接和互动数据。本工具用于搜索视频,不负责播放或下载视频。
ae_zhihu_column_article_detail
获取指定知乎专栏文章的详情记录。请提供必填的文章 ID(字符串)。返回内容包含可用的文章数据及响应元信息。
ae_zhihu_salt_content_search
根据必填关键词搜索知乎盐选内容。可选提供偏移量和每页数量以浏览分页结果;如需延续已有搜索,也可提供搜索哈希 ID。响应包含搜索数据及相关请求元信息。
ae_kuaishou_app_live_top_list
# 用途
获取直播榜单数据,可查询总榜或已支持的分类榜单。
# 输入参数
- `subTabId`:可选整数,用于选择子榜单。总榜使用 `0`;分类榜可使用以下 ID:`102` 音乐、`107` 舞蹈、`101` 颜值、`105` 国艺、`111` 相亲、`106` 游戏、`110` 二次元、`104` 故事、`113` 团播、`114` 九宫格。
- `subTabName`:可选分类名称。选择分类榜时,应与 ID 配套使用:`音乐`、`舞蹈`、`颜值`、`国艺`、`相亲`、`游戏`、`二次元`、`故事`、`团播` 或 `九宫格`。查询总榜时留空或省略即可。
# 返回
返回所选总榜或分类榜的直播榜单数据。
ae_kuaishou_web_video_data
通过share_text查询快手单个视频作品的数据,支持作品链接或分享短链接。视频列表可位于data.photos,具体字段以实际返回为准。不支持图片帖子。
ae_youtube_get_channel_id
根据频道名称查询 YouTube 频道 ID。
输入:
- channel_name(必填,字符串):频道名称,例如 "LinusTechTips"。
返回:
- 包含频道 ID 查询数据的响应。响应数据的具体结构未明确规定,不应假定返回值是单独的 ID 字符串。
输入示例:{"channel_name":"LinusTechTips"}
ae_youtube_search_channels_structured
## 搜索 YouTube 频道
按关键词查找频道,只返回频道搜索结果,不包含视频或播放列表,并支持分页。
### 输入
- `keyword`:搜索关键词,最多 200 个字符。首次请求需要提供;使用分页 token 获取后续页时可不传。
- `continuation_token`:上一页返回的分页 token。首次请求不传,获取下一页时传入。
- `need_format`:默认 `true`,返回结构化频道信息;设为 `false` 时,频道列表返回原始 `channelRenderer` 对象。
### 返回含义
结果数据包含 `keyword`、`channels`、`continuation_token`、`has_more` 和 `total_count`。`total_count` 是当前页的频道数量,不是全部匹配频道的总数。`has_more` 表示是否还有更多频道;使用返回的 token 请求下一页,直到 `has_more` 为 `false`。
当 `need_format=true` 时,频道条目包括:`channel_id`(频道标识)、`title`(名称)、`handle`(自定义标识)、`subscriber_count_text`(订阅者数量的展示文本,并非数值计数)、`description`(描述片段)、`thumbnails`(缩略图)、`is_subscribed`(返回的订阅状态)、`canonical_url`(频道 URL 路径)和 `channel_url`(完整 URL,优先使用自定义 URL)。当 `need_format=false` 时,`channels` 改为原始频道对象列表,分页字段含义不变。
每页通常有 10–20 个频道,但具体数量和排序由 YouTube 决定,不作固定保证。
首次请求示例:`{"keyword":"Rick Astley"}`。
ae_wechat_channels_convert_export_id
将微信视频号搜索结果中的加密 exportId 转换为后续视频查询所需的视频对象标识。必填参数 exportId 为字符串,应取自视频搜索结果。返回包含状态码、转换结果数据、消息和记录时间;转换结果数据的具体结构未明确规定。本工具仅转换标识,不直接获取视频详情或视频内容。
ae_wechat_official_accounts_search_index
提供必填的字符串参数 keyword,查询该关键词的微信指数数据,用于在内容策划、活动规划或进一步文章研究前了解微信内的关注趋势。返回内容包括查询数据、状态码、说明消息和记录时间字段。数据的具体结构、可用指标和时间覆盖范围未作明确约定,应以实际返回结果为准。
ae_bilibili_huahuo_upper_similar
### 用途:
- 发现与指定 UP 主内容方向相近的创作者,用于拓展同类达人候选池。
### 参数:
- `upper_mid`: 必填,目标 UP 主 UID。
### 返回:
- 内容相似 UP 主数组,包含 UID、昵称、头像及相似度相关信息。
AE调用参数示例:
{"upper_mid":3546381696371423}