ae_douyin_xingtu_get_demander_mcn_list
Search for MCN organizations by name or retrieve a page of the organization list.
Inputs (all optional):
- mcn_name: Organization name or partial name for fuzzy search; defaults to an empty string ("").
- page: Integer page number; defaults to 1.
- order_by: Sort option; defaults to "platform_scores" (platform score). Other sort values and sort direction are not documented.
Returns: A response containing MCN organization list data in data and response status information. The detailed fields of each organization entry are not specified.
ae_douyin_xingtu_get_ip_activity_detail
Retrieve details for a specific Xingtu IP calendar activity.
Input: `id` (required integer), the activity ID obtained from the IP activity list. Example: `{"id":347}`.
Result: A response containing the activity's detail data in `data`. This value may be null, and the detail fields are not defined by the response schema. Use this tool once you know the activity ID; it does not list or search activities.
ae_douyin_xingtu_get_ip_activity_industry_list
### Purpose
Retrieve the industry list for the XingTu IP calendar.
### Input
No parameters are required. Use an empty object (`{}`) when calling the tool.
### Result
Returns a response containing industry-list data in `data` and response status information. The exact fields of individual industry entries are not specified, and `data` may be null. This tool returns industries, not individual IP activities or activity details.
ae_douyin_xingtu_get_ip_activity_list
## Purpose
Retrieve Xingtu IP calendar activities for a specified time range, with optional industry, category, and status filters.
## Inputs
Supply a required `request_body` object with:
- `query_start_time` (required string): query start timestamp, e.g. `"1767196800"`.
- `query_end_time` (required string): query end timestamp, e.g. `"1774972799"`.
- `industry_id_list` (optional string array or null): industry IDs. Examples: `["1930"]` for beauty, `["1901"]` for 3C and electronics, `["1903"]` for food and beverage.
- `category_list` (optional integer array or null): 1 = Xingtu major event, 2 = e-commerce occasion, 3 = emotional occasion, 4 = creative marketing, 5 = industry activity.
- `status_list` (optional integer array or null): 40 = preparing, 50 = recruiting, 30 = resources online, 20 = ended.
## Result
Returns a response containing IP calendar activity list data in `data`. This field may be null; the available schema does not specify the fields of individual activities. The tool queries activities; it does not create activities or enroll participants.
ae_douyin_xingtu_get_resource_list
Retrieve a marketing activity case list by resource ID.
Input: resource_id is required and must be an integer, for example 1052.
Returns: a response whose data field contains the marketing activity case data and may be null. The detailed structure and individual case fields are not specified by the response schema.
ae_douyin_xingtu_get_search_field_options
Retrieve filter options that vary by cooperation type in the Xingtu creator marketplace, including fan and audience crowd-profile categories.
Inputs (both optional integers, default 1):
- platform_source: 1 = Douyin; 2 = Toutiao.
- task_category: 1 = Douyin video; 6 = Douyin live; 11 = Toutiao articles.
The result includes service_options, which maps field names to their available option values. Each value is a JSON-encoded string and must be parsed before use. These are filter options, not creator search results. Basic age, gender, region, and device options are provided by separate filter metadata.
Example: platform_source = 1, task_category = 1 retrieves options for Douyin video cooperation.
ae_douyin_xingtu_kol_audience_portrait_v1
Retrieve the V1 audience portrait for a Douyin Xingtu creator (KOL).
Input: kolId is required and must be the creator's Xingtu KOL ID as a string, for example "7048929565493690398". If you only have a uid, sec_user_id, or unique_id, obtain the corresponding kolId with an ID lookup tool first.
Result: The response's data contains the KOL audience portrait and may be null. The documented response does not specify individual portrait attributes or their structure, so available details depend on the returned data.
ae_douyin_xingtu_kol_base_info_v1
Retrieve a Douyin Xingtu creator's basic information. Provide both required inputs as strings: kolId, the creator's Xingtu KOL identifier, and platformChannel, using "_1" for Douyin short video or "_10" for Douyin live streaming. If you only have a UID, sec_user_id, or unique_id, obtain the corresponding kolId first. The response's data field contains the returned basic information and may be null; specific profile fields are not defined in the documented response schema.
ae_douyin_xingtu_kol_link_struct_v1
Retrieve the V1 KOL link-user information for a Douyin Xingtu creator.
Input: kolId is required and must be a string containing the creator's Xingtu KOL identifier, for example "7048929565493690398". If you only have a uid, sec_user_id, or unique_id, first use an identifier lookup to obtain the corresponding kolId.
Result: A JSON response with status information and a data payload containing the returned KOL link-user structure when available. The payload may be null. Its internal fields are not specified in the documented response schema, so a profile URL, contact details, or follower list is not guaranteed.
ae_douyin_xingtu_kol_rec_videos_v1
Retrieve V1 content-performance information for a Douyin Xingtu creator (KOL).
Input: kolId is required and must be a string, for example "7048929565493690398". Use the creator's Xingtu KOL ID, not their UID, sec_user_id, or unique_id. If you only have one of those identifiers, obtain the corresponding kolId first.
Result: The response data field contains the creator's content-performance information and may be null. The detailed result structure and available metrics are not specified; interpret the fields actually returned.
ae_douyin_xingtu_kol_touch_distribution_v1
Retrieve V1 connected-user source distribution (touch distribution) for a Douyin Xingtu creator.
Input: kolId is required and must be the creator's Xingtu ID supplied as a string. If you have only a UID, sec_user_id, or unique_id, first resolve it to a Xingtu kolId.
Returns: a JSON response whose data contains the creator's connected-user source distribution. The available schema does not specify the distribution's detailed fields or categories; data may be null. This result should not be interpreted as a user-level contact list.
ae_douyin_xingtu_kol_xingtu_index_v1
Retrieve a Douyin creator's V1 Xingtu index. Supply the required kolId as a string: this is the creator's Xingtu KOL identifier, not a UID, sec_user_id, or unique_id. If you only have one of those identifiers, resolve it to kolId first. The response data contains Xingtu index information for the specified creator and may be null. Individual index fields, scoring scales, and calculation methods are not defined in the documented response schema.
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
Use this tool to compare an ad material’s performance with other ads in the same industry. Provide the required ad material ID in `request_body.material_id`. You may optionally choose `metric` (default: `ctr_percentile`) from `ctr_percentile`, `time_attr_conversion_rate_percentile`, `click_cnt_percentile`, `time_attr_convert_cnt_percentile`, or `show_cnt_percentile`; set `period_type` in days (default: 180); and provide `cookie` if needed. The response includes the request status and operation data, with percentile results for the selected metric and, when available, related percentile values and industry-average comparisons.
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`。
适合在使用相关搜索功能前,先确认各模块当前是否可用。