statuses/user_timeline
获取某个用户最新发表的微博列表
URL
https://api.weibo.com/2/statuses/user_timeline.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：普通接口
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| uid | false | int64 | 需要查询的用户ID。 |
| screen_name | false | string | 需要查询的用户昵称。 |
| since_id | false | int64 | 若指定此参数，则返回ID比since_id大的微博（即比since_id时间晚的微博），默认为0。 |
| max_id | false | int64 | 若指定此参数，则返回ID小于或等于max_id的微博，默认为0。 |
| count | false | int | 单页返回的记录条数，最大不超过100，超过100以100处理，默认为20。 |
| page | false | int | 返回结果的页码，默认为1。 |
| base_app | false | int | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
| feature | false | int | 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。 |
| trim_user | false | int | 返回值中user字段开关，0：返回完整user字段、1：user字段仅返回user_id，默认为0。 |
注意事项
- 获取自己的微博，参数uid与screen_name可以不填，则自动获取当前登录用户的微博；
- 指定获取他人的微博，参数uid与screen_name二者必选其一，且只能选其一；
- 接口升级后：uid与screen_name只能为当前授权用户；
- 读取当前授权用户所有关注人最新微博列表，请使用：获取当前授权用户及其所关注用户的最新微博接口（statuses/home_timeline）；
- 此接口最多只返回最新的5条数据，官方移动SDK调用可返回10条；
调用样例及调试工具
返回结果
JSON示例
{
"statuses": [
{
"created_at": "Tue May 31 17:46:55 +0800 2011",
"id": 11488058246,
"text": "求关注。"，
"source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>",
"favorited": false,
"truncated": false,
"in_reply_to_status_id": "",
"in_reply_to_user_id": "",
"in_reply_to_screen_name": "",
"geo": null,
"mid": "5612814510546515491",
"reposts_count": 8,
"comments_count": 9,
"annotations": [],
"user": {
"id": 1404376560,
"screen_name": "zaku",
"name": "zaku",
"province": "11",
"city": "5",
"location": "北京 朝阳区",
"description": "人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。",
"url": "http://blog.sina.com.cn/zaku",
"profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1",
"domain": "zaku",
"gender": "m",
"followers_count": 1204,
"friends_count": 447,
"statuses_count": 2908,
"favourites_count": 0,
"created_at": "Fri Aug 28 00:00:00 +0800 2009",
"following": false,
"allow_all_act_msg": false,
"remark": "",
"geo_enabled": true,
"verified": false,
"allow_all_comment": true,
"avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1",
"verified_reason": "",
"follow_me": false,
"online_status": 0,
"bi_followers_count": 215
}
},
...
],
"previous_cursor": 0, // 暂未支持
"next_cursor": 11488013766, // 暂未支持
"total_number": 81655
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| created_at | string | 微博创建时间 |
| id | int64 | 微博ID |
| mid | int64 | 微博MID |
| idstr | string | 字符串型的微博ID |
| text | string | 微博信息内容 |
| source | string | 微博来源 |
| favorited | boolean | 是否已收藏，true：是，false：否 |
| truncated | boolean | 是否被截断，true：是，false：否 |
| in_reply_to_status_id | string | （暂未支持）回复ID |
| in_reply_to_user_id | string | （暂未支持）回复人UID |
| in_reply_to_screen_name | string | （暂未支持）回复人昵称 |
| thumbnail_pic | string | 缩略图片地址，没有时不返回此字段 |
| bmiddle_pic | string | 中等尺寸图片地址，没有时不返回此字段 |
| original_pic | string | 原始图片地址，没有时不返回此字段 |
| geo | object | 地理信息字段 详细 |
| user | object | 微博作者的用户信息字段 详细 |
| retweeted_status | object | 被转发的原微博信息字段，当该微博为转发微博时返回 详细 |
| reposts_count | int | 转发数 |
| comments_count | int | 评论数 |
| attitudes_count | int | 表态数 |
| mlevel | int | 暂未支持 |
| visible | object | 微博的可见性及指定可见分组信息。该object中type取值，0：普通微博，1：私密微博，3：指定分组微博，4：密友微博；list_id为分组的组号 |
| pic_ids | object | 微博配图ID。多图时返回多图ID，用来拼接图片url。用返回字段thumbnail_pic的地址配上该返回字段的图片ID，即可得到多个图片url。 |
| ad | object array | 微博流内的推广微博ID |
其他
无
相关问题
到 帮助中心 查看更多问题或提问
文档更新时间: 2015-03-30
