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_douyin_fetch_user_series_list

## Purpose Retrieve the short-drama series collections published by a Douyin user, one page at a time. ## Inputs - `user_id`: User ID. Supply this or `sec_user_id`; one identifier is sufficient. - `sec_user_id`: Encrypted user ID, as an alternative to `user_id`. - `cursor`: Integer pagination cursor, defaulting to `0` for the first page. For the next page, use the `cursor` returned in the preceding response. ## Result Returns the user's series-list data for the requested page. Returned `series_id` values can be used for subsequent series-detail and video-list lookups. This tool lists collections; it does not itself retrieve their full details or videos. Multiple requests may be needed to browse all collections.

ae_douyin_fetch_video_channel_result

Retrieve video channel data for a specified Douyin channel. Inputs: - tag_id (required integer): Channel tag ID from the channel URL. For https://www.douyin.com/channel/300205, use 300205, not the full URL. - count (optional integer, default 10): Requested number of items. - refresh_index (optional integer, default 1): Refresh index. Its relationship to pagination is not specified. Returns: A JSON response with channel data in data, plus response status and metadata. The data field may be null; its detailed structure is not specified. Example: tag_id=300205, count=10, refresh_index=1.

ae_douyin_generate_short_url

Generate a short link for a Douyin URL. Input: `url` is required and must be a string containing the Douyin link to shorten. Returns: A JSON response containing status information and short-link result data in `data`. The detailed structure of `data` is not specified and it may be null, so the result is not guaranteed to be a plain URL string.

ae_douyin_generate_video_share_qrcode

Generate a QR code for sharing a Douyin video. Input: object_id is required and must be the video ID as a string, for example "7348044435755846962". Result: a response containing QR-code data and status/message information. The QR-code data structure and encoding are not specified, so the result is not guaranteed to be a directly displayable image or image URL.

ae_douyin_index_fetch_all_area

Retrieve the full list of geographic areas supported by Douyin Index. Inputs: None. Call with an empty object ({}). Result: Response data containing a province-and-city hierarchy that can help you choose region filters for keyword index queries. This is a supported-area lookup, not a query for keyword index values or regional performance statistics. The documented response schema does not specify the exact fields of individual area entries.

ae_douyin_index_fetch_brand_hot_videos_time_scope

Retrieves the time range available for brand hot video queries so you can select supported dates before requesting video data. Input: No parameters are required; use an empty object. Result: Time-scope information, such as available start and end dates and period units. The exact response data fields and date formats are not specified. This tool does not return video records or establish date availability for unrelated features.

ae_douyin_index_fetch_brand_initiative_rank_weekly

Retrieve weekly brand initiative ranking data for a brand on Douyin or Toutiao. Inputs: - brand_name (required): Brand name. - start_date and end_date (required): Start and end dates as YYYYMMDD strings. - app_name (optional): aweme for Douyin (default), or toutiao for Toutiao. Returns: A response containing status information and a data payload with the requested weekly brand initiative ranking data. Detailed payload fields and ranking metric definitions are not specified.

ae_douyin_index_fetch_content_author_portrait

Retrieve the aggregate profile of creators who publish Douyin videos in a specific content category. This describes the creators, not their viewers or an individual account. Inputs: - tag_id (required string): A specific content category ID. "0" (all categories) is not supported; choose a nonzero ID from the category filter options. - end_date (required string): The period's end date in YYYYMMDD format. - period (optional): "week" or "month"; defaults to "month". Weekly requests require a Sunday end_date; monthly requests require the last day of the month. The result provides creator portrait distributions such as gender, age group, region, device, and active time. The exact data fields depend on the returned payload, which may be null; no fixed portrait field structure is documented. Example: tag_id="601", period="month", end_date="20260331".

ae_douyin_index_fetch_content_consume_trend

Retrieve daily viewing and content-consumption trends for a specific Douyin category to understand how its viewing popularity changes over time. Required inputs: - tag_id: A specific category ID as a string. "0" (all categories) is not supported. - start_date: Inclusive start date as a YYYYMMDD string. - end_date: Inclusive end date as a YYYYMMDD string. Returns daily aggregated consumption data. Documented metrics include total plays, watch duration, and unique viewers per day. Consumption means content viewing, not monetary spending. The exact metric fields and response layout are not specified by the response schema; use the values actually returned.

ae_douyin_index_fetch_content_creative_duration

## Purpose Retrieve video-duration distribution for a specific content category to understand its video-length structure and creators' preferred lengths. ## Inputs - `tag_id` (required, string): A specific category ID. The all-categories value `"0"` is not supported. - `end_date` (required, string): Reporting end date in `YYYYMMDD` format. Must be a Sunday for weekly reports or the last day of the month for monthly reports. - `period` (optional): `"week"` for weekly reporting (default) or `"month"` for monthly reporting. ## Results Video counts and proportions for each duration bucket. Documented examples include 0–15 seconds, 15–60 seconds, 60–180 seconds, and over 180 seconds. These are aggregate category statistics, not individual video records. Detailed result fields are not fixed by the response schema; interpret the bucket labels and values actually returned.

ae_douyin_index_fetch_content_creative_keyword_items

Retrieve videos associated with a hot keyword in a specific Douyin content category to inspect which videos contribute to that keyword. Inputs and prerequisites: - tag_id (required): A specific category ID. "0" for all categories is not supported. - keyword (required): Select a keyword from the results of fetch_content_creative_keywords first. Use exactly the same tag_id, period, and end_date as in that keyword-list query; mismatched values can produce "json data error". - period (optional): "1" for the past day, "3" for the past 3 days, or "7" for the past 7 days. Defaults to "7". - end_date (required): End date in YYYYMMDD format. It must be a Sunday when period is "7"; for "1" or "3", any date is allowed. Returns: A response containing the videos related to the selected keyword in data. The response schema does not specify individual video fields. This is a keyword drill-down, not an unrestricted keyword search.

ae_douyin_index_fetch_content_creative_keywords

Get popular content-creation keywords for a specific Douyin category to support topic research and content planning. Inputs: - tag_id (required, string): A specific content category ID, such as "601" for drama or "628" for food. "0" (all categories) is not supported. - end_date (required, string): Reporting end date in YYYYMMDD format. It must be a Sunday when period is "7"; any day is allowed for "1" or "3". - period (optional, string): "1" for the last 1 day, "3" for the last 3 days, or "7" for the last 7 days. Defaults to "7", so the Sunday requirement also applies when this parameter is omitted. Returns the popular keyword list for the selected category and period. The detailed fields of individual keyword entries are not specified. Example: tag_id="601", period="7", end_date="20260412".

ae_douyin_index_fetch_content_interact_trend

Retrieve daily interaction trends for a specific Douyin content category to understand changes in audience engagement. Inputs (all required strings): - tag_id: A specific category ID; "0" for all categories is not supported. - start_date: Inclusive start date in YYYYMMDD format. - end_date: Inclusive end date in YYYYMMDD format. Returns daily aggregated interaction data, such as totals for likes, comments, shares, and favorites. The detailed response structure is not specified; available metrics depend on the returned data. This tool provides category-level trends, not individual-content interaction details.

ae_douyin_index_fetch_content_valid_date

Retrieve the available query date ranges for different data types in the Douyin Index creation guide. - Input: No parameters are required. - Result: Start and end dates indicating the periods available for creation-guide queries. The detailed date-range format is not specified in the response schema. - Use this to check date availability before querying creation-guide data; it does not return the underlying content or metrics.

ae_douyin_index_fetch_encrypt_user_id

Convert a Douyin uid into the encrypted user_id used by Douyin Index. Input: uid is required and must be a string containing only digits, for example "3100268042915212". Result: uid is the original input identifier; user_id is the corresponding encrypted identifier. Use this tool for debugging or when you need the encrypted identifier directly. Creator-related operations already perform this conversion automatically, so you usually do not need to call this tool separately.

ae_douyin_index_fetch_insight_get_rec

Find other insight reports related to a report you are viewing. Input: report_id (required string), the current report's ID, obtainable from report search or report recommendations. Example: "1081". Returns: related-report data, described as a list of recommended reports with information such as IDs, titles, covers, and publication times. The exact data structure and field availability are not specified. Use this for related-report discovery or a report detail page's recommendations section; it does not retrieve the current report's full content.