ae_douyin_xingtu_get_demander_mcn_list
按名称搜索 MCN 机构,或分页获取机构列表。
输入(均为可选):
- mcn_name:MCN 机构名称,支持输入部分名称进行模糊搜索,默认空字符串("")。
- page:整数页码,默认 1。
- order_by:排序方式,默认 "platform_scores",表示平台评分;未说明其他排序值或升降序规则。
返回:响应中的 data 包含 MCN 机构列表数据,并附带响应状态信息。机构条目的具体字段未作明确说明。
ae_douyin_xingtu_get_ip_activity_detail
查询指定星图 IP 日历活动的详情。
输入:`id`(必填,整数),即从 IP 活动列表获取的活动 ID。例如:`{"id":347}`。
返回:响应中的 `data` 为该活动的详情数据,可能为空;响应定义未明确列出详情字段。适用于已知活动 ID 后查看详情,不用于搜索或列出活动。
ae_douyin_xingtu_get_ip_activity_industry_list
### 用途
获取星图 IP 日历的行业列表。
### 输入
无需提供参数,调用时传入空对象(`{}`)。
### 返回
响应中的 `data` 包含行业列表数据,并附带响应状态信息。单个行业条目的具体字段未明确约定,`data` 可能为 null。本工具返回行业列表,不返回具体 IP 活动列表或活动详情。
ae_douyin_xingtu_get_ip_activity_list
## 用途
查询指定时间范围内的星图 IP 日历活动,可按行业、活动类型和活动状态筛选,辅助营销日历规划。
## 输入
必须提供 `request_body` 对象,其中包含:
- `query_start_time`(必填,字符串):查询开始时间戳,例如 `"1767196800"`。
- `query_end_time`(必填,字符串):查询结束时间戳,例如 `"1774972799"`。
- `industry_id_list`(可选,字符串数组或 null):行业 ID 列表。例如 `["1930"]` 为美妆,`["1901"]` 为 3C 及电器,`["1903"]` 为食品饮料。
- `category_list`(可选,整数数组或 null):1 = 星图大事件,2 = 电商节点,3 = 情绪节点,4 = 创意营销,5 = 行业活动。
- `status_list`(可选,整数数组或 null):40 = 筹备中,50 = 招商中,30 = 资源上线,20 = 已结束。
## 返回
响应的 `data` 包含 IP 日历活动列表数据,也可能为 null;现有响应定义未明确单条活动的字段结构。本工具仅用于查询,不用于创建活动或报名。
ae_douyin_xingtu_get_resource_list
根据资源 ID 获取营销活动案例列表。
输入:resource_id 为必填整数,表示资源 ID,例如 1052。
返回:响应中的 data 字段承载营销活动案例数据,也可能为 null。响应定义未明确该数据的具体结构或单个案例的字段。
ae_douyin_xingtu_get_search_field_options
获取星图达人广场中随合作类型变化的筛选项取值,例如粉丝、观众的八大人群选项。
输入参数(均为可选整数,默认值均为 1):
- platform_source:平台来源,1 = 抖音,2 = 头条。
- task_category:合作类型,1 = 抖音视频,6 = 抖音直播,11 = 头条图文。
返回结果包含 service_options,表示筛选字段名到可选值的映射;每个字段的值都是 JSON 字符串,需要解析后使用。返回的是筛选选项,不是达人搜索结果。年龄、性别、地域、设备等基础选项需通过单独的筛选元数据功能获取。
示例:platform_source = 1、task_category = 1,获取抖音视频合作对应的筛选选项。
ae_douyin_xingtu_kol_audience_portrait_v1
获取指定抖音星图达人(KOL)的观众画像 V1。
输入:必填参数 kolId,需以字符串形式提供该达人的星图 KOL ID,例如 "7048929565493690398"。若只有 uid、sec_user_id 或 unique_id,应先通过相应的 ID 查询工具获取 kolId,不要直接混用这些标识。
返回:响应中的 data 为该达人的观众画像,也可能为空。文档未定义具体画像属性及其结构,可用信息以实际返回的数据为准。
ae_douyin_xingtu_kol_base_info_v1
查询指定抖音星图达人的基本信息。两个参数均为必填字符串:kolId 为达人的星图 KOL 标识;platformChannel 为平台渠道,"_1" 表示抖音短视频,"_10" 表示抖音直播。如果只有 UID、sec_user_id 或 unique_id,请先查询对应的星图 kolId,不要直接替代 kolId 传入。响应的 data 字段承载返回的达人基本信息,也可能为 null;已提供的响应结构未定义具体资料字段。
ae_douyin_xingtu_kol_link_struct_v1
查询指定抖音星图创作者的 KOL 连接用户信息(V1)。
输入:必填参数 kolId,类型为字符串,表示创作者的星图 KOL 标识,例如 "7048929565493690398"。若只有 uid、sec_user_id 或 unique_id,应先通过标识查询获取对应的 kolId,不要直接将这些标识当作 kolId 使用。
返回:包含状态信息和 data 业务数据的 JSON 响应;data 在有结果时承载 KOL 连接用户结构,也可能为 null。已提供的响应定义未明确该结构的内部字段,因此不保证包含主页链接、联系方式或粉丝列表。
ae_douyin_xingtu_kol_rec_videos_v1
获取指定抖音星图达人(KOL)的内容表现信息(V1)。
输入:必填参数 kolId,类型为字符串,例如 "7048929565493690398"。应提供达人的星图 KOL ID,不要直接使用 UID、sec_user_id 或 unique_id 替代;如果只有这些标识,需先获取对应的 kolId。
返回:响应中的 data 字段承载该达人的内容表现信息,也可能为 null。具体数据结构和可用指标未作明确约定,请以实际返回字段为准。
ae_douyin_xingtu_kol_touch_distribution_v1
查询抖音星图达人的连接用户来源分布(V1)。
输入条件:必填 kolId,类型为字符串,表示该达人的星图 ID。如果仅有 UID、sec_user_id 或 unique_id,需先将其转换为星图 kolId,不能直接替代 kolId 传入。
返回含义:返回 JSON 响应,data 承载该达人的连接用户来源分布。现有响应定义未明确分布的具体字段或分类,data 可能为 null;不应将结果理解为用户级联系人名单。
ae_douyin_xingtu_kol_xingtu_index_v1
查询指定抖音达人的星图指数(V1)。必填参数 kolId 为字符串,表示达人的星图 KOL 标识,不是 UID、sec_user_id 或 unique_id;如果仅有这些标识,请先查询对应的 kolId。返回数据表示该达人的星图指数信息,也可能为空。已提供的响应结构未定义具体指数字段、分值范围或计算方法,请勿自行推断。
ae_tiktok_ads_get_ad_interactive_analysis
用于分析指定广告素材在视频不同时间点的互动表现,帮助了解留存、点击或转化相关指标随时间的变化。
输入参数:
- `material_id`:必填,广告素材 ID。
- `metric_type`:可选,分析类型,可填写 `ctr`(点击率)、`cvr`(转化率)、`clicks`(点击次数)、`conversion`(转化次数)或 `remain`(留存率);默认值为 `remain`。
- `period_type`:可选,分析时间范围,单位为天;默认值为 180。
- `cookie`:可选的自定义 Cookie 字符串。
返回内容:成功响应的 `data` 字段包含互动分析结果,具体内容取决于选择的指标和时间范围。
ae_tiktok_ads_get_ad_percentile
用于比较广告素材与同行业其他广告的相对表现。请在 `request_body.material_id` 中提供必填的广告素材 ID。可选设置 `metric`(默认:`ctr_percentile`),支持 `ctr_percentile`、`time_attr_conversion_rate_percentile`、`click_cnt_percentile`、`time_attr_convert_cnt_percentile` 和 `show_cnt_percentile`;可设置按天计算的 `period_type`(默认:180);如有需要也可提供 `cookie`。返回结果包含请求状态和业务数据,其中包括所选指标的百分位结果,并可能包含相关指标百分位及行业平均值对比。
ae_tiktok_ads_get_ads_detail
获取单个广告的详细信息。请在 `request_body` 中提供必填的 `ads_id` 字符串;`cookie` 为可选的自定义 Cookie 字符串。返回内容包括广告标题、品牌、点赞数、评论数、分享数、点击率、投放国家代码、广告目标、关键词、落地页、标签,以及视频 ID、时长、尺寸、封面和可用播放地址等信息。
ae_tiktok_ads_get_configure_safety
查询创意内容搜索模块的可用性配置。
- **可选输入**:`cookie`,自定义 Cookie 字符串;不需要指定会话时可省略。
- **返回内容**:配置数据包括热门广告、关键词、标签、音乐和创作者搜索的开关状态(通常以 0/1 表示),以及横幅配置键 `cc_banner_key`。
适合在使用相关搜索功能前,先确认各模块当前是否可用。