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_youtube_get_related_videos

Get related or recommended YouTube videos for a given video. Inputs: - video_id (required string): The YouTube video ID, not the full URL. For example, use LuIL5JATZsc from https://www.youtube.com/watch?v=LuIL5JATZsc. - continuation_token (optional string): A token for continuing retrieval of related videos. Omit it for the initial request. Returns: Related-video response data for the supplied video. The detailed fields within that data are not specified.

ae_youtube_get_video_captions_result

## Purpose Check the progress of an existing asynchronous YouTube caption job and retrieve its captions when complete. Each call is a single, non-blocking query; it does not create a job or automatically wait for completion. ## Inputs - **job_id** (required): The job ID returned by a previous caption retrieval request when it reports `status="processing"`. It must be 8–128 characters using only letters, digits, underscores, and hyphens. Use the same account that created the job. - **format** (optional): `srt` (default, SubRip with timestamps), `xml`, `json3`, or `txt` (plain text without timestamps). This choice applies only when the job is complete. ## Results - `queued`: The job is waiting to be processed. - `active`: The job is still processing. - `completed`: The result includes `job_id`, `status`, `language_code`, `language_name`, `format`, `content` (the captions), and `available_languages` (available language codes). For `queued` or `active`, query again later; the recommended interval is 2–5 seconds. Avoid aggressive polling because rate limits apply. Failed jobs return an error. Accessing a job created by another account returns 403.

ae_youtube_get_video_comment_replies

## Get YouTube comment replies Retrieve one page of replies (second-level comments) to a top-level video comment. ### Inputs - **continuation_token** (required string): For the first page, use `reply_continuation_token` from the relevant top-level comment in a video comments response. For later pages, use the `continuation_token` returned with the replies. A video URL or comment ID alone is not the required input. - **language_code** (optional string; default `"zh-CN"`): Language preference, such as `"zh-CN"` or `"en-US"`. - **country_code** (optional string; default `"US"`): Region code, such as `"US"` or `"JP"`. - **need_format** (optional boolean; default `true`): Return cleaned, simplified data when `true`, or raw data when `false`. ### Results and pagination Returns reply data for the requested page. Formatted reply records include the comment ID, text, publication time, like and reply counts, and author details such as channel identity and creator or verification flags. In formatted records, `reply_level: 1` denotes a reply to a top-level comment; `is_creator` indicates whether the author is the video creator. When more replies are available, the returned `continuation_token` can be passed into another call to fetch the next page. One call does not necessarily return every reply. This is a direct data retrieval operation; the token is for pagination, not task polling.

ae_reddit_app_fetch_community_highlights

Retrieve highlights for a Reddit community, such as featured posts, pinned announcements, community updates, and recommended content. Inputs: - subreddit_id (required): The app-format community ID, starting with t5_ followed by 1–17 lowercase letters or digits, for example t5_2qh0u. Supply the ID, not a community name or URL. - language (optional): Preferred response language as an IETF language tag, 2–16 characters; default en-US. - need_format (optional): Whether to clean and format the returned data; default false. Returns a JSON response with community highlight content in data. The detailed content structure is not fixed by the documented schema; data may be null, and the listed content types are not guaranteed to appear in every response.

ae_reddit_app_fetch_games_feed

## Purpose Retrieve the Reddit app gaming recommendation feed, which may include gaming posts, community discussions, and game news or updates. ## Inputs All parameters are optional. - `sort`: Sort order: `BEST`, `HOT`, `NEW`, `TOP`, `CONTROVERSIAL`, or `RISING`. Default: `NEW`. - `time`: Time range: `ALL`, `HOUR`, `DAY`, `WEEK`, `MONTH`, or `YEAR`. Default: `ALL`. - `after`: Pagination cursor for a subsequent page. Default: an empty string for the initial request. Maximum: 4096 characters. - `language`: Preferred response language as an IETF language tag, such as `en-US`. Must be 2–16 characters and match `^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$`. Default: `en-US`. - `need_format`: Whether to request data cleaning and formatting. Default: `false`. ## Result Returns a JSON response containing the gaming feed in `data`, along with response metadata. The content may include posts, discussions, and news or updates. The detailed feed item structure is not specified, and `data` may be null. Do not assume particular post fields or a particular pagination-token field. ## Example `sort="HOT", time="WEEK", after="", language="en-US", need_format=false`

ae_reddit_app_fetch_home_feed

### Purpose Retrieve the Reddit app home feed, with optional sorting, pagination, and exclusion of specified posts. ### Inputs All parameters are optional. - `sort`: Sort order; one of `BEST`, `HOT`, `NEW`, `TOP`, `CONTROVERSIAL`, or `RISING`. Default: `BEST`. - `after`: Pagination cursor for requesting the next page. Default: an empty string; maximum 4096 characters. - `filter_posts`: Post IDs to exclude, for example `t3_1ojjquz`. Default: an empty list; at most 100 IDs. Each ID must start with `t3_` followed by lowercase letters or digits, with a total length of 4–20 characters. - `language`: Preferred response language as an IETF language tag, such as `en-US`. Default: `en-US`. Use a 2–3-letter language code optionally followed by hyphen-separated alphanumeric subtags of 2–8 characters each; total length 2–16 characters. - `need_format`: Whether to request cleaning and formatting of the returned data. Default: `false`. ### Result Returns JSON containing the home-feed result in `data`. The detailed content structure and the effect of formatting on individual fields are not specified; `data` may be null.

ae_reddit_app_fetch_news_feed

## Purpose Retrieve a page of news recommendations from the Reddit app, including news posts and current-affairs discussions when available. ## Inputs All inputs are optional. - `subtopic_ids`: Subtopic IDs to include. Defaults to `["all"]`, meaning all news categories. Supply up to 50 IDs; each must be 1–64 characters containing only letters, digits, underscores or hyphens. - `after`: Pagination value for a subsequent page. Defaults to `""` for the initial request; maximum 4096 characters. - `language`: Preferred response language as an IETF language tag, such as `en-US`. Defaults to `en-US`; must be 2–16 characters and match the parameter's language-tag pattern. - `need_format`: Whether to clean and format the returned data. Defaults to `false`. ## Result Returns JSON containing the news feed in `data`, which may be null. Feed content may include news posts, current-affairs discussions, trending topics, and news sources or links. The nested feed structure is not specified, so individual fields are not guaranteed. Use an available pagination value as `after` to request another page; no particular response field for that value is guaranteed. ## Example `{"subtopic_ids":["all"],"after":"","language":"en-US","need_format":false}`

ae_reddit_app_fetch_search_typeahead

Get autocomplete suggestions for the Reddit app search box based on your search text. Inputs: - query (required): Search text, up to 512 characters. - language (optional): Preferred response language as an IETF language tag, such as en-US. Must be 2–16 characters and match ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$. Default: en-US. - safe_search (optional): "unset" for an unset safe-search setting or "strict" for strict mode. Default: "unset". - allow_nsfw (optional): String "0" to disallow adult content or "1" to allow it. Default: "0". - need_format (optional): Whether to request cleaned and formatted data. Default: false. Returns: JSON search-suggestion data that may include related subreddits, users, suggested search terms, and trending topics. The exact data structure and available categories are not fixed by the documented response schema. These are autocomplete suggestions, not full search results. Example: {"query":"programming","language":"en-US","safe_search":"unset","allow_nsfw":"0","need_format":false}

ae_reddit_app_fetch_subreddit_feed

Retrieve a page of posts from a Reddit subreddit, with optional sorting, post exclusions, and pagination. Inputs: - subreddit_name (required): Bare subreddit name without r/ or a URL, for example AskReddit. Must contain 2–21 ASCII letters, digits, or underscores. - sort (optional): BEST (default), HOT, NEW, TOP, CONTROVERSIAL, or RISING. - filter_posts (optional): Post IDs to exclude, default []. Accepts up to 100 IDs, each 4–20 characters long and matching t3_ followed by lowercase letters or digits. - after (optional): Cursor for the next page, using pagination information from a previous result. Defaults to an empty string; maximum 4096 characters. - language (optional): Preferred response language as an IETF language tag, such as en-US (default). Must be 2–16 characters, starting with 2–3 letters and optionally followed by hyphen-separated segments of 2–8 letters or digits. - need_format (optional): Whether to clean and format the data; defaults to false. Returns: JSON with feed data describing the post list, post details, subreddit metadata, and pagination information when available. The data payload may be null, and its detailed field structure is not fixed by the documented response schema. This is a feed retrieval tool, not a keyword search or comment retrieval tool. Example: {"subreddit_name":"AskReddit","sort":"HOT"}

ae_reddit_app_fetch_subreddit_post_channels

## Purpose Retrieve post-channel information for a specified Reddit subreddit, with sorting and time-range options. ## Inputs All inputs are optional: - `subreddit_name`: Subreddit name without `r/`; 2–21 letters, digits, or underscores. Default: `pics`. - `sort`: `BEST`, `HOT`, `NEW`, `TOP`, `CONTROVERSIAL`, or `RISING`. Default: `HOT`. - `range`: `ALL`, `HOUR`, `DAY`, `WEEK`, `MONTH`, or `YEAR`. Default: `DAY`. The documentation does not specify how each sort mode uses this range. - `language`: Preferred response language as an IETF language tag, such as `en-US`. Must be 2–16 characters and match the parameter's language-tag pattern. Default: `en-US`. - `need_format`: Whether to request cleaned and formatted data. Default: `false`. ## Result Returns a JSON response with the requested subreddit post-channel information in `data`, which may be null. The nested data structure is not specified, so individual post fields are not guaranteed. ## Example `{"subreddit_name":"pics","sort":"HOT","range":"DAY","language":"en-US","need_format":false}`

ae_reddit_app_fetch_subreddit_settings

Retrieve a Reddit subreddit's settings, including posting permissions, content options, and flair configuration. This is a read-only lookup. Inputs: - subreddit_id (required): The full subreddit ID, for example t5_2qh0u. It must start with t5_ followed by 1–17 lowercase letters or digits. Use the ID from subreddit information, not a subreddit name or URL. - language (optional): Preferred response language as an IETF language tag, such as en-US. Length: 2–16 characters; default: en-US. - need_format (optional): Whether to request data cleaning and formatting; default: false. Returns a JSON response with subreddit settings in data. Documented settings include subredditType (public/private/restricted), submissionType (any/link/self), allowImages, allowVideos, allowPolls, suggestedCommentSort, spoilersEnabled, allowedPostTypes, contentOptions, and flairSettings. These describe community visibility, accepted submissions, media permissions, comment sorting, spoiler support, and user/post flair. The data schema is flexible and may be null; individual fields are not guaranteed. Example inputs: {"subreddit_id":"t5_2qh0u","language":"en-US","need_format":false}.

ae_reddit_app_fetch_user_active_subreddits

## Purpose Retrieve the Reddit communities (subreddits) where a specified user posts or comments most actively. ## Inputs - **username** (required): Reddit username, 1–20 characters, using only letters A–Z/a–z, digits, underscores, or hyphens. Provide the username rather than a profile URL. - **language** (optional): Preferred response language as an IETF language tag, such as `en-US`. Defaults to `en-US`. Must be 2–16 characters, starting with a 2–3-letter language code and optionally followed by hyphen-separated alphanumeric subtags of 2–8 characters. - **need_format** (optional): Whether to clean and format the returned data. Defaults to `false`; set to `true` to request formatting. ## Result Returns JSON with the active-community information in `data`. The documented content includes communities where the user is most active, activity information for those communities, and available basic details such as community names, icons, and member counts. The nested data structure is not specified; specific fields, ranking criteria, and the activity reporting period are not guaranteed. This is not a complete post or comment history. ## Example `{"username":"spez","language":"en-US","need_format":false}`

ae_reddit_app_fetch_user_comments

Fetch comments written by a specified Reddit user, with sorting and pagination. Inputs: - username (required): 1–20 letters, digits, underscores, or hyphens. - sort: NEW (newest, default), TOP (top rated), HOT (hot), or CONTROVERSIAL (controversial). - page_size: Number of comments requested per page, from 1 to 100; default 25. - after: Pagination cursor for the next page, using the pagination information from a previous result; default empty, maximum 4096 characters. - language: Preferred response language as an IETF language tag, such as en-US; 2–16 characters, default en-US. - need_format: Whether to clean and format the data; default false. Returns JSON response data for a page of the user's comments and pagination information. Documented comment details include comment content, associated post information, timestamps, upvote counts, and reply counts. The response schema does not specify a fixed structure for these details, so availability depends on the returned data. This tool retrieves comments authored by the user, not the full comment thread of a post.

ae_reddit_app_fetch_user_posts

Fetch posts submitted by a specific Reddit user, with sorting and pagination. Inputs: - username (required): Reddit username, 1–20 characters; letters, digits, underscores, and hyphens only. - sort (optional): NEW (newest, default), TOP (top rated), HOT (hot), or CONTROVERSIAL. - after (optional): Cursor for the next page, obtained from the response's pagination information. Defaults to an empty string; maximum 4096 characters. - language (optional): Preferred response language as an IETF language tag, such as en-US; 2–16 characters, default en-US. - need_format (optional): Whether to clean and format the returned data; defaults to false. Returns a JSON response containing the user's submitted posts and pagination information. Post information may include title, content, submission time, subreddit, upvote and comment counts, post type (text, image, video, or link), and media when available. Detailed data fields can vary; the response does not define a fixed post schema. This tool retrieves posts, not user comments. Example: {"username":"spez","sort":"NEW","after":"","language":"en-US","need_format":false}

ae_reddit_app_fetch_user_profile

Fetch a Reddit user's profile by username. Inputs: - username (required): The username without the u/ prefix; 1–20 characters using only letters A–Z or a–z, digits, underscores or hyphens. - language (optional): Preferred response language as an IETF language tag, such as en-US; 2–16 characters following the input schema. Default: en-US. - need_format (optional): Whether to clean and format the returned data. Default: false. Returns a JSON response with profile information in data when available. Documented details include username and ID, account creation time, post and comment karma, avatar and banner images, bio, verification status, badges and awards, and follower count. The profile payload has no fixed field schema, so use the fields actually returned rather than assuming all listed details are present. Example input: {"username":"spez","need_format":false}

ae_reddit_app_fetch_user_trophies

Fetch a Reddit user's public trophies and achievements. Inputs: - username (required): The Reddit username without u/. Use 1–20 letters (A–Z, a–z), digits, underscores, or hyphens. - language (optional): Preferred response language as an IETF language tag, such as en-US; 2–16 characters, default en-US. - need_format (optional): Whether to clean and format the returned data; default false. Returns: A JSON response with trophy information in data. Available details may include trophy names, descriptions, icon URLs, award dates, and special badges or achievements. The data structure is not fixed and may be null; individual details are not guaranteed. Example: username="spez", need_format=false.