Weibo-App-API

获取用户粉丝列表/Get user followers

Changed on

[中文]

用途:

  • 获取指定用户的粉丝列表,返回粉丝的用户信息(昵称、头像、简介、粉丝数、最新微博等)。

参数:

  • uid: 用户ID(必填)
  • page: 页码,从1开始(默认1)

返回:

  • 粉丝列表数据
    • data.list.users: 粉丝用户数组
    • data.list.next_page: 下一页页码,无更多数据时为 None 或 0
    • data.list.display_total_number: 粉丝总数

注意:

  • 该接口走微博移动端(m.weibo.cn)H5接口,依赖服务端缓存的已登录Cookie,Cookie失效时会返回错误
  • 使用 page 递增翻页,翻到 data.list.next_page 为空或0时表示没有更多数据
  • 每页固定返回20条,微博会过滤部分账号(触发博主自保护策略),因此单页实际返回数量可能不足20条
  • 微博限制粉丝列表的可翻页深度(实测约1000条后 users 返回空数组、next_page 为0)

[English]

Purpose:

  • Get the followers (fans) list of the specified user, returning follower profiles (nickname, avatar, bio, followers count, latest post, etc.).

Parameters:

  • uid: User ID (required)
  • page: Page number, starting from 1 (default 1)

Return:

  • Followers list data
    • data.list.users: Array of follower users
    • data.list.next_page: Next page number, None or 0 when there is no more data
    • data.list.display_total_number: Total followers count

Note:

  • This endpoint uses the Weibo mobile (m.weibo.cn) H5 API and relies on the server-side cached logged-in cookie; an expired cookie results in an error
  • Paginate by incrementing page; there is no more data once data.list.next_page is empty or 0
  • Each page returns 20 items. Weibo filters out some accounts (blogger self-protection strategy), so the actual number of items in a page may be less than 20
  • Weibo limits the pagination depth of the followers list (in practice users becomes an empty array and next_page becomes 0 after roughly 1000 records)

[示例/Example]

uid = "1856404484" page = 1 # First page

page = 2 # Next page

get/api/v1/weibo/app/fetch_user_followers

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Query parameters

uidstring required

用户ID

pageinteger

页码,从1开始

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes