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_weibo_topic_search

# [中文] ### 用途: - 按关键词搜索微博话题,获取话题名称、封面图、讨论量和阅读量。 ### 参数: - `query`: 搜索关键词,必填。 - `page`: 页码,选填,默认值为 1。 ### 返回: - 匹配的话题数据,包括话题名称、封面图、讨论量和阅读量。 - 以“万”或“亿”表示的数量会转换为整数。 # [English] ### Purpose: - Search Weibo topics by keyword and retrieve topic names, cover images, discussion counts, and read counts. ### Parameters: - `query`: Search keyword, required. - `page`: Page number, optional; defaults to 1. ### Returns: - Matching topic data, including topic names, cover images, discussion counts, and read counts. - Values expressed in 万 or 亿 units are converted to integers.

ae_xiaohongshu_pgy_fan_growth_history

获取指定小红书蒲公英创作者在30天或90天内的粉丝历史数据,可用于追踪创作者的粉丝总量走势或新增粉丝增长情况。参数请放在必填的 request_body 对象中。date_type:1=近30天,2=近60天;不提供90天范围。

ae_bilibili_bv_to_aid

Converts a Bilibili video’s BV identifier to its corresponding numeric aid (AV identifier). Enter the complete BV ID in the required `bv_id` field. On success, the response data contains the converted aid; the response may also include general request metadata.

ae_bilibili_fetch_video_parts

Get the available part/segment information for a video. Enter its BV ID as `bv_id`; the returned data contains the video-part information.

ae_douyin_fetch_food_aweme

Retrieve food-related video data from Douyin, one page at a time. Inputs: - count (required integer): Requested number of items per page. For example, 16; you must provide this value explicitly. - refresh_index (optional integer): Paging index; defaults to 1. - cookie (optional string): Your Douyin Cookie. Using your own Cookie is recommended because results may repeat across pages otherwise. Returns: A JSON response with food-video data in data, which may be null. The response also includes status and response metadata. The detailed video fields are not specified; this tool does not guarantee a particular item structure or duplicate-free paging.

ae_instagram_get_user_brief

Retrieve a concise Instagram profile summary by the required username. The response may include the account ID, username, full name, biography, profile picture URL, verification and privacy indicators, and follower and following counts. Optional fields may be absent, and a recent-post preview is not guaranteed.

ae_kuaishou_web_hot_list

# [中文] ### 用途 获取当前的快手热榜 V1,查看热门内容排行。 ### 输入 无需输入参数。 ### 返回 返回热榜数据及相关响应信息。 # [English] ### Purpose Retrieve the current Kuaishou Hot List V1 and view trending content rankings. ### Input No parameters are required. ### Returns The hot-list data and related response information.

ae_youtube_get_shorts_search

## Search YouTube Shorts Find Shorts matching a keyword, with optional localization, upload-time filtering, sorting, and pagination. ### Inputs - **search_query** (required): Search text, up to 200 characters. - **language_code**: Language preference, such as en-US or zh-CN; default en-US. - **country_code**: Country or region code, such as US or JP; default US. - **time_zone**: IANA time zone used for time-related filters, such as Asia/Shanghai; default America/Los_Angeles. - **upload_time**: hour, today, week, month, or year. Omit or use null for no upload-time filter. - **sort_by**: relevance, upload_date, view_count, or rating. Omit or use null for default relevance ordering. If both sorting and an upload-time filter are supplied, sorting takes precedence. - **filter_mixed_content**: Defaults to true to filter long videos from the initial results. Set false to retain the original mixed content, which may include non-Shorts videos. - **continuation_token**: Omit for the first page. To retrieve another page, use a token from the previous response and keep the keyword and other search settings unchanged. Tokens may expire; continuation requests are documented to return Shorts-only content. ### What is returned The response contains raw, nested YouTube search data with search items and a next-page token when available. It is not a cleaned, standardized video list and requires parsing. Pagination tokens fetch additional result pages, not background-task status.

ae_x_get_user_media

## Retrieve user media Retrieve a page of media associated with an X (Twitter) account. ### Inputs - `screen_name` (required string): The account's username, such as `elonmusk`, taken from its profile URL. - `rest_id` (optional integer): The numeric user ID, such as `44196397`. If supplied, it takes precedence over `screen_name` for selecting the account. The input schema still requires `screen_name`. - `cursor` (optional string): Omit for the initial request. To retrieve another page, pass the `next_cursor` returned by the previous response when available. ### Result Returns the account's media in the response data. Individual media fields are not specified by the documented response schema. If a `next_cursor` is returned, it can be used to request a subsequent page. This retrieves media information; it does not download media files. ### Example `{"screen_name":"elonmusk"}`

ae_douyin_creator_fetch_creator_hot_spot_billboard

## Purpose Retrieve Douyin creator hot-spot billboard data to explore overall, local, or rising topics for content planning. ## Inputs - `billboard_tag` (string, default `"0"`): Hot-spot tag codes. Use `"0"` for all tags, or separate multiple codes with commas, such as `"1004,1000,1002"`. - `hot_search_type` (integer, default `1`): `1` = overall hot-spot ranking; `2` = local hot-spot ranking; `3` = rising hot-spot ranking. - `city_code` (string or null): Required when `hot_search_type=2`. Otherwise it may be omitted or null. Supply a city code, not a city name. ### Tag codes by category - Platform features: `1004,1000,1002,1003,1001` - Topic interaction: `20001,20006,20000,20003,20005,20002,20` - Entertainment: `2007,2000,2011,2012,2009,2010,2004,2005,2003,2008,2001,2002,2006` - Society: `4005,4006,4007,4003,4004,4000` - Anime: `13000`; transportation: `23000`; parenting: `19000` - Sports: `5002,5000,5001`; military: `21000`; drama: `18000` - Animals and pets: `8000`; weather: `22001,22002`; talent: `17000` - Culture and education: `14000`; travel: `10000`; fashion: `16000` - Politics: `3000,3001,3002`; campus: `15000`; automotive: `11000` - Gaming: `12000,12001`; technology: `6000`; food: `9000`; finance: `7000` ## Result Returns the creator hot-spot billboard data for the requested ranking and filters in `data`, together with response status metadata. The detailed fields of individual entries are not specified. This is a topic billboard, not a creator-account ranking. ## Example `{"billboard_tag":"0","hot_search_type":1}` requests the overall ranking across all tags.

ae_douyin_index_fetch_hot_trend_word

## Purpose Get popular keyword suggestions from the keyword index search box to help choose inputs for keyword index analysis. Suggestions are updated daily; this is not a real-time or rapidly rising hot-topic leaderboard and does not provide keyword index measurements. ## Inputs Both inputs are optional: - `app_name`: `aweme` for Douyin (default) or `toutiao` for Toutiao. Toutiao currently returns an empty list. - `type`: `0` for search words (default), whose `id` is always the string `"0"`; `1` for content words with topic IDs. ## Result - `update_time`: the data update date, reflecting daily rather than real-time updates. - `trend_words`: the recommended word list, with `id` and `word` for each entry. Example: `app_name="aweme", type=0` requests Douyin search-word suggestions.

ae_kuaishou_app_user_data

Fetch data for one user by providing a required user_id string. The value may be either the user's eid or userId. The response returns the user data when available, along with status, message, and request metadata.

ae_douyin_fetch_multi_video_high_quality_play_url

## Purpose Retrieve highest-quality playback links for up to 50 Douyin videos in one request. “Original-upload quality” means the quality of the creator's uploaded video, not an upscaled or enhanced version. Useful for video editing, archiving, and other workflows that need high-quality source links. ## Inputs - `request_body`: Required request object. - `request_body.aweme_ids`: Video IDs as a comma-separated string, such as `"7512756548356492544,7448118827402972455"`. Supply no more than 50 IDs, rather than an array or share URLs. - `request_body.region`: Optional ISO country code, such as `CN`, `US`, or `HK`, for the request's egress region. The region can affect the CDN links returned; mainland China users can use `CN` for potentially faster downloads. ## Results The response data includes `total` (total count), `success_count` (successful retrievals), `failed_count` (failed retrievals), and `videos` (per-video results). Each video entry includes: - `video_id`: Video ID. - `original_video_url`: Highest-quality, original-upload-quality playback link. - `file_size` and `file_size_in_mb`: File size in bytes and MB, respectively. - `content_type`: Content type. - `success`: Whether that video's retrieval succeeded. - `error`: Error information if retrieval failed. Check individual success flags and errors because a batch may contain failures. Larger batches can take longer, so allow additional waiting time. The tool returns links and metadata, not downloaded video files.

ae_douyin_index_fetch_content_publish_trend

Retrieve the daily number of videos published in a specific Douyin content category to understand changes in content supply over time. Required inputs: - tag_id: A specific category ID, supplied as a string. "0" (all categories) is not supported. - start_date: Inclusive start date in YYYYMMDD format. - end_date: Inclusive end date in YYYYMMDD format. Returns daily aggregated publication data: each date and the number of videos published that day. These counts measure publication activity, not views or engagement.

ae_douyin_search_fetch_discuss_search

## Purpose Search Douyin discussion and Q&A content by topic. Results can be sorted and filtered by publication time, video duration, and content format. This tool searches discussion/Q&A content rather than all Douyin content and does not retrieve a comment thread. ## Inputs Provide a required `request_body` object. Its fields are optional: - `keyword`: Search text; defaults to `"猫咪"`. - `cursor`: Integer pagination cursor; defaults to `0`. - `search_id` and `backtrace`: Pagination identifiers; both default to `""`. - `sort_type`: `"0"` comprehensive (default), `"1"` most likes, `"2"` latest. - `publish_time`: `"0"` unrestricted (default), `"1"` last day, `"7"` last week, `"180"` last half year. - `filter_duration`: `"0"` unrestricted (default), `"0-1"` within one minute, `"1-5"` one to five minutes, `"5-10000"` over five minutes. - `content_type`: `"0"` all (default), `"1"` video, `"2"` picture, `"3"` article. Use strings for filter values. For the first page, set `cursor` to `0` and leave `search_id` and `backtrace` empty. For later pages, use the corresponding values from the previous response when available. ## Returned information The response contains a status code and `data` holding search results, which may be null. Documented result items include a result type and `aweme_info` with content ID, description, author information, video playback and cover links, engagement counts, hashtags, music, content status, and a share link where available. Engagement counts can include likes, comments, shares, plays, and collections; they are not the comments themselves. Video duration in returned metadata is measured in milliseconds. Actual data structure and field availability may vary.

ae_douyin_search_fetch_experience_search

## Purpose Search Douyin's experience-oriented content, such as knowledge sharing, tutorials, tips, and guides, using a keyword. ## Inputs Provide a required `request_body` object. All fields inside it are optional: - `keyword`: Search text; defaults to `"猫咪"`. - `cursor`: Integer pagination cursor; defaults to `0`. - `search_id` and `backtrace`: String pagination identifiers; both default to `""`. - `sort_type`: `"0"` comprehensive ranking, `"1"` most likes, or `"2"` latest. - `publish_time`: `"0"` no limit, `"1"` last day, `"7"` last week, or `"180"` last half year. - `filter_duration`: `"0"` no limit, `"0-1"` within one minute, `"1-5"` one to five minutes, or `"5-10000"` more than five minutes. - `content_type`: `"0"` all, `"1"` video, `"2"` pictures, or `"3"` articles. All four filter fields are strings and default to `"0"`. For the first page, use `cursor: 0` and empty `search_id` and `backtrace`. For subsequent pages, use the pagination values returned by the previous response. ## Results Returns a response object with search results in `data`. Documented result structures include `business_data` blocks containing `aweme_list` video entries. Entries may provide content IDs, descriptions, publication timestamps, author profiles, music, hashtags, playback and cover URLs, engagement statistics, video status, and share links. Video duration, when supplied in `video.duration`, is measured in milliseconds. The search payload is not constrained to a fixed schema and may be null; field availability depends on the actual response.