ae_tiktok_ads_get_recommended_ads
根据指定的参考广告查找相似的推荐广告。请在 request_body.material_id 中提供必填的参考素材 ID。可选提供 industry、country_code 或 cookie,其中 industry 和 country_code 有默认值。返回结果包含推荐广告素材,以及可用的广告标题、品牌名称、表现与互动数据、分类字段和视频详情(如时长、封面、尺寸及播放地址)。如果没有返回素材,可尝试调整或移除筛选条件。
AgentEarth 工具目录
提供社交媒体账号、帖子与笔记、评论及互动数据的查询能力,支持账号研究、话题追踪和内容表现分析,覆盖 X(Twitter)、小红书、Reddit、TikTok 等平台。
工具列表
ae_tiktok_ads_get_recommended_ads
根据指定的参考广告查找相似的推荐广告。请在 request_body.material_id 中提供必填的参考素材 ID。可选提供 industry、country_code 或 cookie,其中 industry 和 country_code 有默认值。返回结果包含推荐广告素材,以及可用的广告标题、品牌名称、表现与互动数据、分类字段和视频详情(如时长、封面、尺寸及播放地址)。如果没有返回素材,可尝试调整或移除筛选条件。
ae_tiktok_analytics_detect_fake_views
用于评估短视频的流量质量和潜在虚假观看风险。请提供视频作品 ID;也可以选择内容分类,以调整互动率基准。结果会汇总视频指标、互动率、创作者与内容指标、虚假观看风险评分、估计虚假及有机观看量、流量层级分析、可疑特征和建议操作;在适用情况下还可能包含商业影响报告。
ae_tiktok_check_live_room_online
检查直播间当前是否在线。 输入: - `room_id`:必填,直播间 ID,字符串。 返回: - 在线状态检查结果,通常位于响应的 `data` 中;同时可能包含请求状态等标准响应信息。
ae_tiktok_check_live_room_online_batch
## 用途 批量检测多个 TikTok 直播间当前是否在线,每次最多支持 50 个直播间 ID。 ## 输入 需要提供必填的 `request_body` 对象,其中包含 `room_ids` 字段。`room_ids` 必须是由 TikTok 直播间 ID 字符串组成的数组。 ## 返回 返回数据包含所提交直播间对应的在线状态结果,同时可能包含响应状态和请求标识等响应元数据。
ae_tiktok_fetch_gift_name_by_id
根据单个 TikTok Gift ID 查询对应的礼物名称。输入参数为 request_body.gift_id,类型为字符串,例如 "10001"。返回的响应 data 字段包含对应的礼物名称查询结果。
ae_tiktok_fetch_gift_names_by_ids
批量查询多个礼物 ID 对应的礼物名称。请通过 request_body.gift_ids 提供至少一个礼物 ID 字符串;返回数据包含对应的查询结果。
ae_tiktok_fetch_search_photo
用于按关键词搜索照片。keyword 是必填的搜索关键词;count 默认为 20。首次搜索可使用默认的 offset 和 search_id,继续翻页时请填写上一页响应中获取的分页值。cookie 为可选参数,仅在需要时提供。返回照片搜索结果及相关响应信息。
ae_tiktok_fetch_user_like
获取用户的公开点赞视频列表。 ### 参数 - `secUid`:用户的 secUid,必填。 - `cursor`:分页游标,默认值为 `0`。 - `count`:每页数量,默认值为 `20`。 - `coverFormat`:封面格式,默认值为 `2`。 - `post_item_list_request_type`:排序方式,默认值为 `0`;可选值包括 `0`(默认排序)、`1`(热门排序)和 `2`(最旧排序)。 ### 返回 返回该用户点赞列表对应的响应数据。 ### 注意 - 用户的点赞列表必须处于公开状态。 - 返回数据中的视频 CDN 直链可能需要携带响应中的 `tt_chain_token`,请求时使用请求头 `Cookie: tt_chain_token={tt_chain_token}`。 - 如果该直链仍返回 HTTP 403,请改用响应中以 `https://www.tiktok.com/aweme/v1/play/` 开头的视频链接,并且不要携带上述 Cookie。
ae_tiktok_fetch_user_mix
获取指定用户合辑中的视频,并支持使用游标分页。必填参数:`mixId`,合辑标识。可选参数:`cursor`(分页起始游标,默认值为 `0`)和 `count`(每页请求数量,默认值为 `30`)。响应返回合辑的视频列表数据,以及服务返回的分页信息。
ae_tiktok_fetch_user_play_list
获取用户的播放列表。 参数: - `secUid`(必填):用户的 secUid。 - `cursor`(可选,默认值为 `0`):播放列表分页游标。 - `count`(可选,默认值为 `30`):每页请求的条目数量。 返回播放列表数据,数据中可能包含视频 URL 列表,同时返回响应和请求元信息。视频 CDN 直链可能需要使用响应中的 token 设置请求头 `Cookie: tt_chain_token={tt_chain_token}`。如果直链返回 HTTP 403,请改用视频 `UrlList` 中的 TikTok 播放链接,并且不要携带 Cookie。
ae_tiktok_fetch_user_repost
获取用户的转发作品列表。必填参数:secUid,用户标识。可选参数:cursor,分页位置,默认为 0;count,每页数量,默认为 20;coverFormat,封面格式,默认为 2,支持 1 和 2。响应会在 data 字段中返回转发作品,并附带响应元数据。如果结果包含媒体链接,请遵循返回链接或令牌对应的访问要求。
ae_tiktok_get_creator_search_insights_detail
查询特定搜索词条的创作者搜索洞察详情。 参数: - `query_id_str`(必填):搜索词条 ID,可从创作者搜索洞察数据中获取。 - `time_range`(可选):`past_7_days`、`past_30_days`(默认)、`past_60_days`、`past_6_months` 或 `custom`。 - `start_date` 和 `end_date`(可选):自定义时间范围的 Unix 时间戳(秒)。使用自定义范围时须同时提供两者,且范围不能超过六个月。 - `dimension_list`(可选):以逗号分隔的维度,可选 `gender`、`age` 和/或 `country`。 返回搜索洞察详情数据,包括搜索趋势和用户画像。
ae_tiktok_get_creator_search_insights_trend
### 用途 获取已有查询词的创作者搜索趋势洞察,包括地区搜索热度和时间趋势。 ### 参数 - `query_id_str`(必填):查询 ID,需从创作者搜索洞察结果中获取。 - `from_tab_path`(可选):来源标签路径,默认值为 `TRENDING,TOPICS`。 - `query_analysis_required`(可选):是否需要查询分析,默认值为 `true`。 ### 返回 指定查询词的搜索趋势数据,可包含地区热度和随时间变化的趋势。
ae_tiktok_get_creator_search_insights_videos
根据创作者搜索洞察关键词获取相关热门视频。请输入关键词,可选设置分页偏移量(默认 0)和每页数量(默认 20),查看相关视频结果。关键词可来自创作者搜索洞察或创作者搜索趋势。
ae_tiktok_get_hashtag_detail
获取指定话题的详情。话题 ID 为必填项。地区为可选项,支持 US、GB、FR、JP、VN、SG;未提供时默认为 US。返回数据包含话题详情。
ae_tiktok_get_music_chart
获取 TikTok 音乐排行榜条目。`scene` 设为 0 表示 Top 50,设为 1 表示 Viral 50。使用 `cursor` 翻页(默认 0),并使用 `count` 设置每页数量(默认 50,最大 50)。响应包含榜单数据,例如歌曲信息和排名变化,以及状态、生成时间等响应元数据。