{
  "openapi": "3.0.0",
  "info": {
    "title": "Weibo User Fans API (V1)",
    "version": "1.0.0",
    "description": "Get Weibo user Fans data, including profile metadata and verification signals, for audience analysis and influencer research."
  },
  "paths": {
    "/api/weibo/get-fans/v1": {
      "get": {
        "tags": [
          "Weibo"
        ],
        "summary": "User Fans",
        "description": "Get Weibo user Fans data, including profile metadata and verification signals, for audience analysis and influencer research.",
        "operationId": "getFansV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "API access token.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "uid",
            "in": "query",
            "description": "Weibo User ID (UID).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number, starting with 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          }
        ],
        "responses": {
          "default": {
            "description": "default response",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "users": [
                      {
                        "id": 8379504929,
                        "idstr": "8379504929",
                        "class": 1,
                        "screen_name": "果酱_12",
                        "name": "果酱_12",
                        "province": "100",
                        "city": "1000",
                        "location": "其他",
                        "description": "",
                        "url": "",
                        "profile_image_url": "https://tvax1.sinaimg.cn/default/images/default_avatar_male_50.gif?KID=imgbed,tva&Expires=1773075610...",
                        "light_ring": false,
                        "profile_url": "u/8379504929",
                        "domain": "",
                        "weihao": "",
                        "gender": "m",
                        "followers_count": 0,
                        "followers_count_str": "0",
                        "friends_count": 2,
                        "pagefriends_count": 0,
                        "statuses_count": 0,
                        "video_status_count": 0,
                        "video_play_count": 0,
                        "super_topic_not_syn_count": 0,
                        "favourites_count": 0,
                        "created_at": "Sun Mar 08 21:31:27 +0800 2026",
                        "following": false,
                        "allow_all_act_msg": false,
                        "geo_enabled": true,
                        "verified": false,
                        "verified_type": -1,
                        "remark": "",
                        "insecurity": {
                          "sexual_content": false
                        },
                        "status_id": -1,
                        "status_idstr": "-1",
                        "ptype": 0,
                        "allow_all_comment": true,
                        "avatar_large": "https://tvax1.sinaimg.cn/default/images/default_avatar_male_180.gif?KID=imgbed,tva&Expires=177307561...",
                        "avatar_hd": "https://tvax1.sinaimg.cn/default/images/default_avatar_male_180.gif?KID=imgbed,tva&Expires=177307561...",
                        "verified_reason": "",
                        "verified_trade": "",
                        "verified_reason_url": "",
                        "verified_source": "",
                        "verified_source_url": "",
                        "follow_me": false,
                        "like": false,
                        "like_me": false,
                        "online_status": 0,
                        "bi_followers_count": 0,
                        "lang": "zh-cn",
                        "star": 0,
                        "mbtype": 0,
                        "mbrank": 0,
                        "svip": 0,
                        "vvip": 0,
                        "mb_expire_time": 0,
                        "block_word": 0,
                        "block_app": 0,
                        "chaohua_ability": 0,
                        "brand_ability": 0,
                        "nft_ability": 0,
                        "vplus_ability": 0,
                        "wenda_ability": 0,
                        "live_ability": 0,
                        "gongyi_ability": 0,
                        "paycolumn_ability": 0,
                        "newbrand_ability": 0,
                        "ecommerce_ability": 0,
                        "hardfan_ability": 0,
                        "wbcolumn_ability": 0,
                        "interaction_user": 0,
                        "audio_ability": 0,
                        "place_ability": 0,
                        "credit_score": 80,
                        "user_ability": 0,
                        "urank": 0,
                        "story_read_state": -1,
                        "vclub_member": 0,
                        "is_teenager": 0,
                        "is_guardian": 0,
                        "is_teenager_list": 0,
                        "pc_new": 0,
                        "special_follow": false,
                        "planet_video": 0,
                        "video_mark": 0,
                        "live_status": 0,
                        "user_ability_extend": 0,
                        "status_total_counter": {
                          "total_cnt": 0,
                          "repost_cnt": 0,
                          "comment_cnt": 0,
                          "like_cnt": 0,
                          "comment_like_cnt": 0
                        },
                        "video_total_counter": {
                          "play_cnt": -1
                        },
                        "brand_account": 0,
                        "hongbaofei": 0,
                        "green_mode": 0,
                        "green_mode_source": 0,
                        "delete_mode_time": 0,
                        "urisk": 0,
                        "unfollowing_recom_switch": 1,
                        "block": 0,
                        "block_me": 0,
                        "avatar_type": 0,
                        "is_big": 0,
                        "auth_status": 1,
                        "auth_realname": null,
                        "auth_career": null,
                        "auth_career_name": null,
                        "show_auth": 0,
                        "is_auth": 0,
                        "is_punish": 0,
                        "like_display": 0,
                        "comment_display": 0,
                        "fansIcon": {
                          "fans_uid": 8379504929,
                          "val": 0,
                          "member_rank": 0,
                          "svip": 0,
                          "vvip": 0,
                          "lighting": false,
                          "icon_url": "",
                          "uid": 8379504929,
                          "name": ""
                        }
                      }
                    ],
                    "has_filtered_attentions": false,
                    "next_cursor": 20,
                    "previous_cursor": 0,
                    "total_number": 4534662,
                    "use_sink_stragety": false,
                    "has_filtered_fans": false,
                    "use_status_strategy": false,
                    "show_related_topic": false,
                    "display_total_number": 4534662,
                    "display_total_number_str": "453.5万",
                    "sort_type": 0,
                    "type": 0,
                    "show_unread": false,
                    "fill_material": 0,
                    "screenName": "王牌对王牌",
                    "ok": 1
                  }
                }
              }
            }
          }
        },
        "x-order": "17001300"
      }
    }
  },
  "components": {}
}