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_reddit_comment_request

Retrieve comments on a Reddit post. Provide the required reddit_id with the t3_ prefix; the ID can be obtained from social_media_search. Optionally specify page (default: 1); each page returns 20 records. The provider has not specified the response structure.

ae_douyin_creator_fetch_creator_hot_topic_billboard

Retrieve the Douyin creator hot-topic leaderboard to discover popular topics by category, ranking measure, and time window. Inputs (all optional integers): - billboard_tag: category ID; defaults to 0 for all categories. Documented values: 333=Food, 334=Travel, 299=Lifestyle, 335=Automotive, 336=Technology, 302=Gaming, 296=Anime, 337=Entertainment, 311=Celebrity, 298=Sports, 300=Culture & Education, 301=Campus, 297=Government, 305=Fashion, 306=Talent, 669=Finance, 314=Everyday snapshots, 307=Animals & Plants, 309=Images & Text, 308=Drama, 315=Parenting, 718=Agriculture & Rural Affairs, 310=Creative, 312=Outdoor, 926=Public Welfare. Other category IDs should be obtained from category configuration rather than guessed. - order_key: ranking measure; 1=highest views (default), 2=most likes, 3=most comments, 4=most submissions. - time_filter: time window; 1=24 hours (default), 2=7 days, 3=30 days. Returns creator hot-topic leaderboard data for the selected filters in the response data field. The detailed structure of leaderboard entries is not specified. This is a topic leaderboard, not an individual creator ranking. Example: billboard_tag=0, order_key=1, time_filter=1 requests topics across all categories ranked by highest views over 24 hours.

ae_douyin_index_fetch_item_sug

Get keyword autocomplete suggestions for video search. Input: - query (required, string): The search keyword to obtain suggestions for. Example: "打瓦". Result: - Matching keyword suggestions for refining or completing a search, not a list of videos. - Suggestions are returned in the response data; the detailed structure of individual suggestions is not specified.

ae_douyin_index_fetch_portrait

Retrieve an audience portrait for a keyword on Douyin or Toutiao within a specified date range. Inputs: - keyword (required): The keyword to analyze. - start_date (required): Start date as a YYYYMMDD string, for example "20260406". - end_date (required): End date as a YYYYMMDD string, for example "20260412". - app_name (optional): aweme for Douyin (default), or toutiao for Toutiao. Returns: Audience analysis in the response's data field, covering distributions such as gender, age, region, and interests. These describe the audience associated with the keyword for the selected platform and period. The exact dimensions and value formats depend on the returned data; the response schema does not define a fixed portrait structure, and data may be null.

ae_douyin_xingtu_search_anchor

## Purpose Search for Douyin live-stream anchors by nickname, Douyin ID, Xingtu ID, or a live-content keyword, then narrow the results for creator discovery and cooperation planning. ## Inputs - **Required:** `keyword` (string). - **Paging and sorting:** `page` defaults to `1`; `sort_field` defaults to `score` (overall ranking); `sort_type` is `1` for ascending or `2` for descending, with `2` as the default. - **Cooperation:** `task_category` (default `6`), `marketing_target` (default `3`), `first_industry_id`, and `author_list_id` (featured creator list ID). - **Creator fit:** `tag` accepts comma-separated category IDs. `persona_tags` accepts persona, education, certification, or style IDs: commas mean match any, while semicolon-separated groups must all match. `gender` is `1` for male or `2` for female; `fans_min` and `fans_max` set follower bounds. - **Live-stream quotes:** `price_min` and `price_max` are nonnegative integers. If either is provided, also supply `price_type=9`. These parameters filter anchor quotes, not the cost of using this tool. - **Performance:** optional minimum/maximum pairs for `expected_play`, `cpm`, `cpe`, `interact_rate`, `play_over_rate`, and `burst_text_rate` filter expected plays, expected CPM/CPE, interaction rate, completion rate, and viral-post rate. Rate values are decimals from `0` to `1`; `0.02` means 2%. - **Audience/profile criteria:** `extra_filter` is a JSON-array **string**, not a native array. Each item must contain non-empty string values for `field_name` and `field_value`; `rel_id` is optional. Use documented field names, category IDs, and encoded values rather than free-form labels. For example, the string `[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.6"}]` expresses a documented female audience share threshold. ## Results Returns search response data for matching anchors. Documented information includes anchor details, live-stream quotes, ACU/PCU (average/peak concurrent viewers), and average viewers per session, when available. The result data has no fixed detailed schema and may be null; individual metrics are not guaranteed. This tool discovers anchors; it does not book cooperation or play live streams. ## Example `{"keyword":"游戏","page":1,"gender":2,"fans_min":10000}` searches using the gaming keyword with female-creator and minimum-follower filters.

ae_x_get_latest_post_comments

Retrieve the latest comments on an X (Twitter) post. Inputs: - tweet_id (required, string): The ID of the post whose comments you want to retrieve. - cursor (optional, string): A pagination cursor from the previous response. Omit it for the initial request, and supply a returned cursor to continue. Returns: Comment data for the specified post. The response does not define a fixed structure for individual comments or a fixed location for pagination cursors.

ae_douyin_billboard_fetch_hot_account_fans_interest_search_list

Retrieve 10 search terms reflecting a Douyin account's followers' interests over the last 3 days. Input: sec_uid (required string), the target account's user sec_id. Returns: search-term data with response metadata. The detailed result fields are not specified. These terms concern the account's followers, not the account owner's personal search history. The time window and number of terms are fixed; custom dates and result counts are not supported.

ae_douyin_creator_fetch_creator_material_center_billboard

## Purpose Retrieve the popular-video billboard from the Douyin Creator Center material center for trend discovery and content research. ## Inputs All parameters are optional integers. - `billboard_tag` — category filter; default `0` means all categories. Documented IDs: `333` food; `334` travel; `299` lifestyle; `335` automotive; `336` technology; `302` gaming; `296` anime; `337` entertainment; `311` celebrity; `298` sports; `300` culture and education; `301` campus; `297` government; `305` fashion; `306` talent show; `669` finance; `314` casual captures; `307` animals and plants; `309` graphics and text; `308` drama; `315` parenting; `718` agriculture; `310` creative; `312` outdoor; `926` public welfare. Use documented category IDs rather than guessing other values. - `order_key` — ranking metric; `1` highest views (default), `2` most likes, `3` most comments, `4` highest popularity. - `time_filter` — time window; `1` 24 hours (default), `2` 7 days, `3` 30 days. ## Result Returns the requested popular-video billboard payload in `data`, along with response metadata. The detailed payload structure is not specified and `data` may be null; specific video fields and item counts are not guaranteed. ## Example `{"billboard_tag":333,"order_key":2,"time_filter":2}` requests the food-category billboard ranked by likes over 7 days. Omitting all parameters requests all categories ranked by views over 24 hours.

ae_douyin_search_fetch_challenge_search_v1

## Purpose Search Douyin for hashtag/challenge topics related to a keyword. Results are topic entries, not a list of individual videos or posts. ## Inputs Provide a required `request_body` object. All fields inside it are optional: - `keyword` (string): search term, for example `food`; default: `猫咪` (cats). - `cursor` (integer): pagination cursor; default `0` for the first request. - `search_id` and `backtrace` (strings): pagination identifiers; both default to an empty string. For later pages, reuse the values returned by the previous response when available, together with its cursor. - `sort_type` (string): `"0"` comprehensive, `"1"` most likes, `"2"` latest. - `publish_time` (string): `"0"` unrestricted, `"1"` last day, `"7"` last week, `"180"` last half year. - `filter_duration` (string): `"0"` unrestricted, `"0-1"` within one minute, `"1-5"` one to five minutes, `"5-10000"` over five minutes. - `content_type` (string): `"0"` all, `"1"` video, `"2"` image, `"3"` article. All sorting and filter fields default to `"0"`. Despite the available content filters, the documented output remains topic-only. ## Results Returns a response envelope with a status `code` and a `data` payload, which may be null. Documented search data can include: - `challenge_list`: topic entries. Each entry may contain `challenge_info` with `cid` (topic ID), `cha_name` (name), description, `view_count` (total views), `user_count` (participants), `hashtag_profile` (cover URL), and sharing/deep links. - `author`: creator information within a topic entry, such as user ID, nickname, follower count, verification status, region, and avatar URLs. - `cursor`: cursor for the next request; `has_more`: `1` if more results are available, `0` otherwise. The payload has no fixed detailed schema; listed fields describe common documented results and may not all be present. Use the actual response for pagination and available topic details.

ae_douyin_search_fetch_challenge_suggest

## Purpose Find Douyin topic, hashtag, and challenge suggestions related to a keyword. Useful for search autocomplete and discovering relevant topics. ## Input - `request_body` (required object): request payload. - `request_body.keyword` (optional string): search keyword, such as `游戏`; the schema default is `游戏`. Example: ```json {"request_body":{"keyword":"游戏"}} ``` Only the keyword is exposed inside the request body; pagination inputs are not supported by this tool's public schema. ## Result The response envelope includes `code` (HTTP status code), `data` (result data), and response metadata. Documented common fields in the result data include: - `sug_list`: suggested topics, with `cha_name` (topic name), `view_count` (total views), `cid` (challenge ID), `group_id` (associated group ID), and `tag` (0 = normal topic, 1 = hot trend). - `status_code`: result status; 0 indicates success. - `status_msg`: result status message. - `rid`: result request ID; additional query and logging metadata may also be present. The result data has an open-ended schema; actual fields and their availability depend on the response. These are topic suggestions, not video or user search results.

ae_douyin_xingtu_get_kolid_by_sec_user_id

Look up a Douyin user's Xingtu KOL identifier (kolid). Input: sec_user_id is required and must be a string containing the user's Douyin sec_user_id, obtainable from Douyin profile information. Supply the identifier itself, not a nickname or profile URL. Result: The lookup returns the associated Xingtu kolid available through the guest-facing lookup. This identifies the user in Xingtu and is distinct from the input Douyin identifier. The response has a general envelope with a data payload whose detailed structure is not specified.

ae_tiktok_ads_get_top_contents_list

### Purpose Retrieve the Creative Center Top Contents ranking for a selected period and country, useful for trend discovery, content research, and creative inspiration. The ranking corpus contains 100 videos; `page` and `limit` determine which portion is returned. ### Input Pass a JSON `request_body` with the required `period_end_timestamp`: a nonzero 10-digit Unix timestamp in seconds generated for the target ranking date. For `period_dimension=1` (weekly), use Sunday 00:00 UTC; for `period_dimension=3` (daily) or `5` (long-period), use a past date. Optional fields: - `period_dimension`: `1` weekly, `3` daily (default), or `5` long-period. - `country_code`: country/region code (default `US`). Some regions may have no ranking data. - `content_label_ids`: comma-separated content label IDs; empty means all categories. - `order_by_metric`: `1` views (default), `2` engagement rate, or `3` six-second view-through rate. - `organic_only`: return only organic-traffic content (default `false`). - `page`: page number (default `1`). - `limit`: items per page (default `20`, maximum `100`). - `cookie`: optional custom cookie string. ### Output The response data includes `entityInfos`, a list of ranked videos, and `pagination`. Video entries can include item details such as title, creation time, cover and video URLs, performance metrics such as views, engagement rate, and six-second view-through rate, author information and follower metrics, and content tags. An empty `entityInfos` may be a normal result when the selected region is not covered. A page beyond the 100-item ranking may return an out-of-range error.

ae_tencent_huxuan_search_video_account_creators

Search or browse video-account creators to discover potential partners for advertising campaigns. Optionally provide keyword to search by creator nickname; leave it empty to browse the default marketplace list. Use page to select a result page, starting at 1 (the default). The response includes query data (data), a status code (code), a message (message), and a recorded time (recordTime). The structure of data and the creator details available are not specified by the response schema.

ae_bilibili_fetch_user_relation_stat

### Purpose Retrieve relationship counts for a user identified by their UID. ### Input - `uid` (string, required): The user's ID. ### Result The returned relationship statistics include `following` (the number of accounts the user follows) and `follower` (the number of followers).

ae_douyin_fetch_brand_hot_search_list

Retrieve category data for Douyin's brand hot-search list. Inputs: No parameters are required; use an empty object ({}). Returns: A JSON response with category data in the data field and response status metadata. The data field may be null, and the detailed category structure is not specified. This tool does not accept a specific brand, category, date, or pagination filter; its documented purpose is category retrieval rather than individual brand ranking details.