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_bilibili_huahuo_search_upper

### Purpose: - Search creators by nickname, UID, or content keyword in the Huahuo marketplace. - Combine profile, audience, pricing, performance, DMP, industry, cooperation-experience, and commerce filters. - `nickname_or_mids` and `main_search` correspond to creator search and content search respectively; normally choose one per request. ### Parameters: #### Basic search parameters: - `nickname_or_mids`: Creator nickname or UID query; separate multiple terms with commas. - `main_search`: Content-keyword query with matched videos included in the result. Normally use either this field or `nickname_or_mids`. - `mids`: Exact UID list; `upper_mid`: One exact UID; `folder_id`: Saved-creator folder ID. - `marketing_target`: `1`=brand awareness, `2`=consideration, `3`=conversion. - `panel_type`: `0`=general, `1`=gaming, `2`=beauty, `3`=digital, `4`=automotive, `5`=performance, `6`=food, `8`=internet services. - `order_by`: Sort field; `sort`: `desc` or `asc`; `page`: One-based page number with 20 results per page; `request_id`: Optional search-session ID that can be reused across pages with the same filters. #### Creator profile and affiliation parameters: - `gender`: Value from `square_static_info.gender_info`. - `min_fans_num` / `max_fans_num`: Inclusive follower-count range. - `region_id` / `second_region_id`: Primary and secondary residence-region IDs from `region_drop`. The Beijing, Shanghai, Fujian, Xiamen, and Fuzhou selection is `{"region_id":[4,5,23],"second_region_id":[51,50]}`. - `partition_id` / `second_partition_id`: Primary and secondary content-category IDs. - `mcn_ids`: MCN IDs; `provider_id`: Service-provider IDs. - `upper_types`: `1` or `4`=MCN-affiliated, `3`=independent. - `only_contract`: `1`=contract-eligible creators only, `0`=all. - `is_painter_order`: Require illustration-commission capability. #### Audience and DMP parameters: - `fans_age_tag`, `fans_gender_tag`, `fans_region_tag`: Audience age, gender, and region affinity tags; `fans_stick`: Follower-loyalty tier. - `av_active`: Enable recent-publishing filtering; `av_active_tag`: Activity tier. - `dmp_group_id`: Custom DMP package ID; `category_dmp_group_id` and `category_dmp_label`: Category-package ID and display label. - `dmp_pkg_name`: Special-audience package name query. - `dmp_pkg_vertical_rate_gte` / `dmp_pkg_vertical_rate_lte`: DMP verticality range, measured as matching videos divided by all videos in the last 180 days. - `dmp_pkg_effect_rate_gte` / `dmp_pkg_effect_rate_lte`: DMP influence range, measured as recent matching viewers divided by that audience population. - `dmp_pkg_fan_rate_gte` / `dmp_pkg_fan_rate_lte`: DMP attention range, measured as matching audience members divided by all followers. #### Pricing and performance parameters: - `min_task_price` / `max_task_price`: Standard cooperation quote range in RMB. - `price_info`: Cooperation-specific pricing array; the current UI submits one selected cooperation type per search. Each item contains: - `cooperation_type`: Video cooperation uses `1`=embedded video, `2`=custom video, and `22`=deep customization; podcast cooperation uses `23`=custom podcast and `24`=podcast brand placement; dynamic cooperation uses `3`=direct post and `4`=repost. Placement formats embed brand material in the content, custom formats are produced for the client's marketing needs, and dynamic formats publish or repost the requested commercial post. - `price_min` / `price_max`: Quote range in RMB for that cooperation type. - `creative_skill`: Deep-customization skill IDs `1-9`, covering overseas filming, technical analysis, microfilm, live-action challenge, renovation/DIY, interview, TVC filming, special editing, and other. - `include_content`: Included-content IDs for custom video, deep customization, or custom podcast: `1`=secondary creation/distribution license, `2`=bonus preview, `3`=custom content. - `price_right`: Cooperation-right codes. Types `1/2/23/24` support `show_in_video_first_1p3` and `show_in_video_gte_30s`; type `22` supports `brand_over_30_percent`, `auth_secondary_creation`, `multi_cooperation_discount`, `give_preview`, and `give_poster`. Types `3/4` do not support this field and use `[]`. - Every `price_info` item contains all six fields. Send `[]` for an unavailable or unselected `creative_skill`, `include_content`, or `price_right`. “RMB 100,000 or more” is `"price_min":100000,"price_max":""`. - Deep-custom example: `{"price_info":[{"cooperation_type":22,"creative_skill":[1,2,3],` `"include_content":[1,2,3],"price_min":100000,"price_max":"",` `"price_right":[]}]}`. - Embedded-video example: `{"price_info":[{"cooperation_type":1,"creative_skill":[],` `"include_content":[],"price_min":100000,"price_max":"","price_right":[]}]}`. - Custom-podcast example: `{"price_info":[{"cooperation_type":23,"creative_skill":[],` `"include_content":[1],"price_min":100000,"price_max":"","price_right":[]}]}`. - Direct-post example: `{"price_info":[{"cooperation_type":3,"creative_skill":[],` `"include_content":[],"price_min":100000,"price_max":"","price_right":[]}]}`. - Call `GET /api/v1/bilibili/huahuo/square_static_info` first and read `data.price_info_options` for cooperation types, price ranges, rights, included content, and creative skills. Each item in `cooperation_type` declares its usable request fields in `supported_fields`. - `last_7_days_set_price`, `last_14_days_set_price`, `last_30_days_set_price`: `1` requires a quote set in the selected period; `0` means unrestricted. - `min_interact_rate` / `max_interact_rate`: Engagement-rate range for eligible original videos in the last 180 days. - `blue_url_ctr_gte` / `blue_url_ctr_lt`: Blue-link CTR range; `blue_url_click_cost_gte` / `blue_url_click_cost_lt`: Blue-link click-cost range. - `min_play_median` / `max_play_median`: Median-view range for eligible original videos published at least seven days ago. - `play_median_traffic_type`: `1`=all, `2`=organic; `play_median_cycle`: `1/2/3`=7/15/30 days. Example for “300,000-500,000, 15 days, organic”: `{"min_play_median":"300000","max_play_median":"500000",` `"play_median_traffic_type":2,"play_median_cycle":2}`. - `min_cpm` / `max_cpm`: CPM range; `cpm_type`: `1`=all, `2`=organic; `cpm_cycle`: `1/2/3`=7/15/30 days. - `min_cpc` / `max_cpc`: CPC range; `cpc_traffic_type`: `1`=all, `2`=organic; `cpc_cycle`: `1/2/3`=7/15/30 days. - `cpe_gte` / `cpe_lt`: CPE range; `cpe_traffic_type`: `1`=all, `2`=organic; `cpe_cycle`: `1`=7 days, `3`=30 days. #### Content and cooperation parameters: - `draft_duration`: Dominant video duration: `1`=0-30s, `2`=30-60s, `3`=1-3m, `4`=3-5m, `5`=5-10m, `6`=over 10m. - `min_avid_cnt` / `max_avid_cnt`: Eligible original-video count range over 90 days. - `min_hot_avid_rate` / `max_hot_avid_rate`: Viral-video ratio range over 90 days. - `half_min_hot_avid_cnt` / `half_max_hot_avid_cnt`: Viral-video count range over six months. - `entry_cost_min` / `entry_cost_max`: Store-entry cost range over the last year. - `av_honor`: Honor filter containing a multi-select `honor_type` array (`HOT`, `MZBK`, and/or `QZPHB`), `time_period` (`0/30/90/180` days), and `honor_count` (`0/1/2/3`, where 3 means 3+). Multi-select example: `{"av_honor":{"honor_type":["HOT","QZPHB"],"time_period":90,` `"honor_count":2}}`. - The general panel's cooperation-count filter uses `spark_tag`: `cooperate`=experienced or `coo_frequent`=extensive experience; choose one. Cooperation industries come from `square_static_info.industry_tree`; send selected paths in `huahuo_first_industry_ids`, `huahuo_second_industry_ids`, and `huahuo_third_industry_ids`. For “real estate/all with experience”: `{"spark_tag":["cooperate"],"huahuo_first_industry_ids":["388"],` `"huahuo_second_industry_ids":["389","393","399","401","403"],` `"huahuo_third_industry_ids":["390","394","395","396","398",` `"400","402","404"]}`. Merge IDs from all selected paths for a multi-industry request. - Non-general strategy panels use `cooperate_experience_industry_ids` with `cooperate_experience_type`. Without selected industries, the type options are `3`=no current-industry experience, `1`=experienced, `2`=extensive experience, and `4`=experience in other industries. With selected industries, use `1` or `2`. `cooperate_experience_industry` supplies those strategy-panel industry values. #### Labels and industry parameters: - `special_tags`: Feature tags; `spark_tag`: Capability tags such as `cooperate`, `grow`, and `hot_frequent`; `square_tag_in`: Marketplace scenario tags. - `label_array`: Contains only selected node `value`s from the “Content type” group returned by `upper_label_tree`. Put all selected content types in one inner array without parent-path values. Single “Outdoor adventure” selection: `{"label_array":[[794]]}`; multiple “Outdoor adventure, AI short film, AI entertainment” selections: `{"label_array":[[794,747,748]]}`. - `bdata_tag_lv5`: Bilibili level-five content-tag values. - `huahuo_first_industry_ids`, `huahuo_second_industry_ids`, `huahuo_third_industry_ids`: Primary, secondary, and tertiary Huahuo industry IDs. #### Commerce parameters: - `goods_permission`: `1`=require commerce permission, `0`=all; `goods_up_levels`: Commerce-creator levels. - `goods_category_first_ids` / `goods_category_second_ids`: Commerce-category IDs. - `goods_gpm_min` / `goods_gpm_max`: 30-day paid GMV per 1,000 commerce-video views. - `goods_ctr_min` / `goods_ctr_max`: Component CTR range; `goods_ctr_type`: `1`=all components, `2`=comment component. - `goods_avg_price_min` / `goods_avg_price_max`: 30-day average product-price range in RMB. - `goods_is_high_video_play_permeate`: Require high video-view penetration; `goods_is_high_fans_play_permeate`: Require high follower-view penetration. #### Status and high-potential parameters: - `is_boosting`: Require currently boosted creators; `is_treasure_up`: Treasure creators; `is_timely_response`: Timely-response creators; `is_new_enter`: Newly onboarded creators. - `custom_video_pricing_set`: Require configured custom-video pricing; `is_x_plan_better_up`: X Plan preferred creators. - `high_potential_type`: `0`=all, `1`=onboarded, `2`=not onboarded. #### Filter value sources: - Content types: call `GET /api/v1/bilibili/huahuo/upper_label_tree?panel_type=0`, read node `value`s from the Content type group, and build `label_array`. - Residence regions: call `GET /api/v1/bilibili/huahuo/region_drop`; use primary `value`s in `region_id` and selected child `value`s in `second_region_id`. - General-panel cooperation industries: call `GET /api/v1/bilibili/huahuo/square_static_info`, read the three-level `data.industry_tree`, and fill the matching `huahuo_*_industry_ids` arrays. Use `spark_tag` with `cooperate` or `coo_frequent` for cooperation count. - Non-general-panel cooperation experience: call `GET /api/v1/bilibili/huahuo/cooperate_experience_industry?industry_type=<TYPE>`, then set `cooperate_experience_industry_ids` and `cooperate_experience_type`. - Cooperation pricing: call `GET /api/v1/bilibili/huahuo/square_static_info`, read `data.price_info_options`, and build `price_info`. Median views and video honors use the fixed enums and Request Payload Examples documented here. - Other dynamic sources: call `GET /api/v1/bilibili/huahuo/square_static_info` for audience, gender, activity, and feature tags; `GET /api/v1/bilibili/huahuo/partition_drop` for first- and second-level video categories; `GET /api/v1/bilibili/huahuo/mcn_drop?name=` for MCNs; `GET /api/v1/bilibili/huahuo/dmp_pkg_list` for custom DMP packages; and `GET /api/v1/bilibili/huahuo/effect_goods_drop` for commerce categories. ### Returns: - `page`: Current page number. - `total_count`: Total matching records, displayed up to 10,000. - `data`: Creator records commonly containing `upper_mid`, `nickname`, `fans_num`, `play_median`, `interactive_rate`, pricing, content and industry labels, DMP measurements, and commerce metrics. Content-search results also include matched videos. AE input example: {"request_body":{"main_search":"科技","page":1,"marketing_target":1,"panel_type":0}}

ae_x_twitter_get_affiliates_by_username

X关联账号(按用户名)。列出指定机构用户名的公开关联账号列表;仅必填screen_name用户名,无需数字ID或先调用其他工具查询ID。首次省略cursor,继续查询时使用本接口上次返回的next_cursor。每次直接返回一页,数量可变,不自动翻页,也不保证一次查全。关联账号列表位于data.affilates(字段按返回拼写),并在提供时返回next_cursor;个别字段可能缺失,不保证统计字段齐全。适用于具有公开关联账号的机构,个人账号可能无结果;并非关注列表或粉丝列表。

ae_x_twitter_get_followers_by_username

X粉丝列表(按用户名)。列出关注指定账号的粉丝,适合受众研究与社交关系分析,不是该账号关注的人或关联账号。仅需填写screen_name用户名,无需数字ID,也无需先调用其他工具。首次省略cursor,后续将本接口返回的next_cursor填入cursor继续查询。每次仅返回一页,数量可变,不自动翻页,也不保证一次查全。返回包含data.followers和next_cursor,个别字段可能缺失,以实际返回为准,不保证所有账号统计字段齐全。

ae_x_twitter_get_following_by_username

X关注列表(按用户名)。列出指定用户名账号关注的用户列表;必填screen_name用户名,不要求数字ID,也无需先调用其他工具查ID。首次省略cursor;后续将本接口上次返回的next_cursor作为cursor传入。每次直接返回一页,关注列表位于data.following,并在可用时返回next_cursor;数量可变,不自动翻页,不保证一次查全。适合查看账号关注对象和分析关注关系,不用于查询粉丝或关联账号。个别字段可能缺失,统计信息以实际返回为准。