Sort

AgentEarth Tool Catalog

Social Media

852Tools
12tags
14Providers

Query social media profiles, posts, notes, comments and interaction data for account research, topic tracking and content performance analysis across platforms such as X (Twitter), RedNote (Xiaohongshu), Reddit and TikTok.

  1. Find information using accounts, content URLs or keywords, and retrieve followers, likes, comments and other data through the relevant tools.
  2. Support brand monitoring, competitor account research, topic tracking and content performance analysis with data for agent research tasks.

Tool List

852 tools

ae_tiktok_fetch_user_live_detail

### 用途 查询指定用户的直播详情。 ### 输入 - `uniqueId`:必填,用户的唯一标识。 ### 返回 返回查询响应及直播详情数据;当没有可用直播详情时,详情数据可能为空。

ae_weibo_web_post_detail

获取单条微博的详细信息。 必填参数: - `id`:微博作品 ID。 可选参数: - `is_get_long_text`:是否获取长微博全文,填写字符串 `"true"` 或 `"false"`,默认值为 `"true"`。 返回内容: - 微博的响应数据;在数据可用时,可能包含正文、作者信息、图片或视频等媒体信息,以及点赞、评论、转发等互动数据。

ae_kuaishou_app_videos_batch

Use this tool to retrieve data for multiple videos or works in a single request. Enter 1–40 IDs in the photo_ids field as a comma-separated string; numeric IDs and short string IDs may be mixed. The response includes the retrieved video data in its data field, along with status and response metadata.

ae_x_get_user_about

Retrieve about/profile information for an X (Twitter) account. Input: screen_name (required string), the account's username, for example "elonmusk". Returns: Account profile information in the response data, which may include registration time, account status, and usage information. Individual profile fields are not specified by the response schema and may vary.

ae_douyin_billboard_fetch_hot_total_list

## Purpose Retrieve the Douyin overall hot-topic ranking at a snapshot time or over a date range, with pagination and optional filters. ## Inputs - Required: `page` (integer page number), `page_size` (integer number of items per page), and `type` (time-selection mode). - For `type="snapshot"`, use `snapshot_time` in `yyyyMMddHHmmss` format. Its default is `20250106151500`, not a request for the latest snapshot; set it explicitly for the intended time. - For `type="range"`, use `start_date` and `end_date` in `yyyyMMdd` format. They default to empty strings. `snapshot_time` applies only to snapshot mode; the date fields apply only to range mode. - Optional `sentence_tag`: category tags from the hot-ranking category list, separated by commas. An empty value includes all categories. - Optional `keyword`: a hot-topic search term; defaults to an empty string. ## Result Returns hot-topic ranking data for the requested page, time selection, and filters in the response's `data` field, along with response metadata. Individual ranking-item fields are not specified by the documented response schema.

ae_douyin_fetch_music_video_list

Retrieve a list of Douyin videos associated with a specified music. Inputs: - music_id (required string): The music ID, for example "7136850194742315016". - cursor (optional integer, default 0): Use 0 for the first page. For subsequent pages, use the cursor returned in the previous response. - count (optional integer, default 10): Keep this at 10; changing it may cause errors. Returns: Response data containing the video list associated with the music. Detailed fields for individual video items are not specified. Example: music_id="7136850194742315016", cursor=0, count=10.

ae_douyin_xingtu_get_ranking_list_data

## Purpose Retrieve creator ranking data for a selected category, ranking type, reporting date, and weekly or monthly period. Supported contexts include short-video business rankings, short-video content rankings, and live-stream creator rankings. ## Inputs All five inputs are optional and have fixed defaults: - `code` (integer, default `1`): ranking type. Short-video business codes: `1` brand preferred, `2` A3 seeding, `3` search after viewing, `4` e-commerce, `5` ad traffic, `6` high potential. Short-video content codes: `17` follower-growth dark horses and `18` top must-pick creators. For live-stream creator types with `version="base"`: `23` gaming, `30` other, `37` e-commerce. Live ranking-type codes: `23` gaming-industry brand preferred, `24` non-gaming-industry brand preferred, `25` component clicks, `26` download conversions, `27` lead collection, `28` ad traffic, `29` high potential. Code meanings depend on the ranking context; in particular, `23` has more than one documented meaning. - `qualifier` (string, default `"1901"`): category ID obtained from the ranking catalog. Use the ID corresponding to the intended ranking category. - `version` (string, default `"flow_split"`): `flow_split` is the default for short-video rankings; `base` is commonly used for live rankings. - `period` (integer, default `30`): `7` for weekly rankings or `30` for monthly rankings. - `date` (string, default `"20260131"`): reporting date in `YYYYMMDD` format. Specify the date you want; the fixed default is not the current date. ## Result Returns a response object with the requested ranking payload in `data`, which may be null, and a response status in `code`. The response status code is distinct from the input ranking-type code. The available schema does not define individual ranking-entry fields or metrics. Example inputs: `code=1`, `qualifier="1901"`, `version="flow_split"`, `period=30`, `date="20260131"`.

ae_tiktok_get_user_info

Retrieve profile information for a specified user. Provide at least one identifier: sec_user_id or a numeric user_id. If both are provided, sec_user_id takes precedence. The response includes user information and request status details.

ae_weibo_advanced_search

Search Weibo posts by keyword and refine the results with optional filters. Inputs: - q (required string): Search keyword. - search_type (optional string or null): all (all posts), hot (popular), original (original posts), verified (verified users), media (media accounts), or viewpoint (viewpoints). - include_type (optional string or null): all, pic (images), video, music, or link (short links). - timescope (optional string or null): Custom time range in the format custom:start:end, for example custom:2025-09-01-0:2025-09-08-23. - page (optional integer): Results page number; defaults to 1. Returns: A response containing search results in data. Results may include post content, author information, images, videos, and interaction metrics. The exact result structure and available fields can vary; the documented data schema does not specify individual result fields. Note: To play a returned video, the playback request must include Referer: https://weibo.com/. This header is not a search input.

ae_instagram_search_users

### Purpose Find Instagram users by searching with a keyword. ### Input - `keyword` (string, required): the search term. ### Response - `data.items`: the matching user results. The response may also include status and request metadata.

ae_youtube_search_channels_legacy

## Purpose Search YouTube channels using a channel ID and search keywords. ## Inputs - `channel_id` (required string): Channel ID. - `search_query` (required string): Search keywords. - `language_code` (optional string): Language code; defaults to `en`. - `country_code` (optional string): Country code; defaults to `us`. - `continuation_token` (optional string): Token for continuing search results. Omit it for an initial request; supply a token from earlier results when available. ## Result Returns the search response directly. The `data` field holds the search result payload and may be null. The response also includes status and message information. The result item structure and pagination-token location are not specified, so available details depend on the returned payload. Both a channel ID and search keywords are required; this is not an ID-free channel search.

ae_bilibili_fetch_hot_search

Retrieves hot-search information. Provide `limit`, an integer specifying how many entries to return (default: 10; maximum: 50). The response includes the returned hot-search data; its specific fields depend on the data provided by the service.

ae_douyin_fetch_home_feed

Retrieve the Douyin web home recommendation feed, either as a guest or personalized for an account. Inputs are optional and belong inside request_body: - count: Integer number of items requested. Defaults to 10; keeping this default is recommended. - refresh_index: Integer refresh/page index, default 0. Use 0 for the initial feed or a refresh. To load more, increment the index by 1 for each subsequent page. - cookie: Web Douyin login cookie, default empty. Provide it for that account's personalized recommendations; omit it for general guest recommendations. Returns a response object containing the feed payload in data, along with status and response metadata. The detailed fields within the feed payload are not specified.

ae_douyin_get_all_aweme_id

Extract Douyin video IDs from up to 20 links in one request. Input: request_body is a required array of strings. Each entry can be a Douyin short link, a full video/share URL, or copied share text containing a video link. Result: The response data contains the extracted video IDs, which identify the videos for subsequent lookups. This tool extracts IDs rather than returning video details or media files. The exact result layout and handling of individual unparseable links are not specified in the documentation. Example input: {"request_body":["https://v.douyin.com/iRNBho6u/","https://www.douyin.com/video/7298145681699622182"]}

ae_tiktok_get_sec_user_id

# Purpose Extract the sec_user_id associated with a TikTok user profile page. # Parameter - `url` (required): The user's profile page URL, for example `https://www.tiktok.com/@tiktok`. # Return The account's sec_user_id, a platform-specific user ID.

ae_weibo_hot_search

Retrieve the current Weibo hot-search ranking, including trending search terms and popularity information. Inputs (all optional): - category: Ranking category. Default: realtimehot. Documented values: mineband (My hot search), realtimehot (real-time hot search), social (society), fun (entertainment), technologynav (technology), lifenav (lifestyle), region (local), sportnav (sports), and gamenav (ACG). - page: Integer page number starting at 1; default 1. - count: Integer number of items per page, from 1 to 50; default 20. - region_name: City name, effective only when category=region; defaults to 北京 (Beijing). Supported names include 北京, 上海, 广州, 深圳, 杭州, 成都, 重庆, 武汉, 南京, 天津, 西安, 长沙, 郑州, 苏州, 东莞, 青岛, 沈阳, and 合肥. Returns ranking data for the requested category and page. The detailed data structure is not specified. Rankings update over time, so results may differ between requests. Example: category="region", region_name="上海", page=1, count=20.