获取用户粉丝列表/Get user fans list

获取微博用户粉丝列表/Get Weibo user fans list

功能说明/Function Description

获取指定用户的粉丝列表，查看有哪些用户关注了该用户，支持分页加载。/Get the fans list of a specified user, view which users follow that user, supports pagination.

参数说明/Parameter Description

uid (必填/Required): 微博用户ID/Weibo user ID

类型/Type: 字符串/String

示例/Example: "1722594714"

说明/Description: 要查看粉丝列表的目标用户ID/Target user ID to view fans list

page (可选/Optional): 页码/Page number

类型/Type: 整数/Integer

默认值/Default: 0

示例/Example: 0

说明/Description: 用于分页获取，从0开始/Used for pagination, starting from 0

分页使用方法 📖/Pagination Usage 📖

返回数据结构/Return Data Structure

{
  "code": 200,
  "data": {
    "ok": 1,
    "data": {
      "fans_list": [
        {
          "用户ID/User ID": "string",
          "用户名/Username": "string",
          "昵称/Nickname": "string",
          "头像/Avatar": "string",
          "认证信息/Verification": "string",
          "简介/Description": "string",
          "粉丝数/Followers count": "number",
          "关注数/Following count": "number",
          "微博数/Posts count": "number",
          "关注时间/Follow time": "string"
        }
      ],
      "total_count": "粉丝总数/Total fans count",
      "has_more": "是否还有更多/Has more",
      "next_page": "下一页页码/Next page number"
    }
  }
}

与关注列表接口的区别 🆚/Difference from following list API 🆚

fetch_user_following: 获取用户的关注列表（该用户关注了谁）/Get user's following list (who the user follows)
fetch_user_fans:      获取用户的粉丝列表（谁关注了该用户）/Get user's fans list (who follows the user)

使用场景 👥/Use Cases 👥

粉丝分析/Fan analysis: 分析用户的粉丝构成和特征/Analyze user's fan composition and characteristics

影响力评估/Influence assessment: 评估用户在社交平台上的影响力和受欢迎程度/Assess user's influence and popularity on social platforms

用户互动/User interaction: 了解用户与粉丝的互动关系/Understand interaction relationships between users and fans

营销分析/Marketing analysis: 为营销策略提供粉丝画像数据/Provide fan profile data for marketing strategies

社交研究/Social research: 研究用户的社交影响力扩散模式/Study user's social influence dissemination patterns

数据价值 📊/Data Value 📊

🎯 受众画像/Audience profile: 分析粉丝的年龄、性别、兴趣等特征/Analyze fans' age, gender, interests and other characteristics

📈 影响力指标/Influence metrics: 通过粉丝质量评估用户的真实影响力/Assess user's real influence through fan quality

🔍 互动分析/Interaction analysis: 识别活跃粉丝和潜在的意见领袖/Identify active fans and potential opinion leaders

💡 精准营销/Precision marketing: 为广告投放和营销活动提供目标受众数据/Provide target audience data for advertising and marketing campaigns

最佳实践 💡/Best Practices 💡

分页策略/Pagination strategy: 根据粉丝数量合理设置分页大小/Set reasonable page size based on fan count

数据缓存/Data caching: 对粉丝列表进行适当缓存，提升查询效率/Properly cache fan lists to improve query efficiency

质量筛选/Quality filtering: 可以根据粉丝的活跃度和认证状态进行筛选/Filter based on fan activity and verification status

隐私保护/Privacy protection: 遵守平台隐私政策，保护用户数据/Comply with platform privacy policies and protect user data

性能优化建议 ⚡/Performance Optimization Suggestions ⚡

批量处理/Batch processing: 合理控制并发请求数量/Reasonably control concurrent request count

增量更新/Incremental updates: 只获取新增或变化的粉丝数据/Only get new or changed fan data

索引优化/Index optimization: 对常用查询字段建立索引/Create indexes for commonly queried fields

数据压缩/Data compression: 对大量粉丝数据进行适当压缩存储/Properly compress and store large fan data

注意事项 ⚠️/Important Notes ⚠️

粉丝列表受用户隐私设置影响/Fan list is affected by user privacy settings

部分用户可能设置为不公开粉丝列表/Some users may set fan list as private

page参数从0开始，而不是1/page parameter starts from 0, not 1

粉丝数量可能很大，需要合理控制获取范围/Fan count may be large, need to reasonably control fetch range

粉丝列表可能包含僵尸粉或无效账号/Fan list may contain bot fans or invalid accounts

建议合理控制请求频率，避免触发平台限制/Recommend reasonable request frequency control to avoid platform limits

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "2025-09-16 03:14:36",
    "time_stamp": 1758017676,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取用户粉丝列表/Get user fans list

获取微博用户粉丝列表/Get Weibo user fans list#

功能说明/Function Description#

参数说明/Parameter Description#

分页使用方法 📖/Pagination Usage 📖#

返回数据结构/Return Data Structure#

与关注列表接口的区别 🆚/Difference from following list API 🆚#

使用场景 👥/Use Cases 👥#

数据价值 📊/Data Value 📊#

最佳实践 💡/Best Practices 💡#

性能优化建议 ⚡/Performance Optimization Suggestions ⚡#

注意事项 ⚠️/Important Notes ⚠️#

Request