微博API

微博开放平台，通常会在每周二晚上上线新的代码到线上环境。 我们会通过微博开放平台的官方微博、问答系统、博客、甚至邮件，通知开发者任何重要的变更，确保开发者了解这些变动及其所带来的影响。同时，我们知道任何细微的变化也可能会影响到开发者及他们的应用，所以我们在下面提供一个不定期更新日志，以便开发者查询。 2013-06-24

自2013年7月2日起，微博开放平台将对用户关系读取、微博内容读取类接口进行升级；为保证您的线上应用正常运营，请在7月2日前对以下接口进行升级；本次升级对微博类客户端和合规的应用没有影响。升级中，遇到任何问题，请私信，感谢您的理解支持！具体调整接口如下：

获取当前登录用户发布的微博消息列表（2/statuses/user_timeline ）

获取当前登录用户发布的微博消息ID列表（2/statuses/user_timeline/ids ）

获取用户的关注列表（2/riendships/friends）

获取共同关注人列表（2/friendships/friends/in_common）

获取双向关注列表（2/friendships/friends/bilateral）

获取双向关注UID列表（2/friendships/friends/bilateral/ids）

获取用户关注对象UID列表（2/friendships/friends/ids）

获取用户粉丝列表（2/friendships/followers）

获取用户粉丝UID列表（2/friendships/followers/ids）

获取用户优质粉丝列表（2/friendships/followers/active） 2013-03-18

发布授权回收接口，帮助开发者主动取消用户的授权。详情见： 2013-02-25

微博读取接口新增批量获取指定的一批用户的微博列表高级接口（2/statuses/timeline_batch）。

微博读取接口新增根据微博ID批量获取微博信息高级接口（2/statuses/show_batch）。

关注读取接口新增批量获取当前登录用户的关注人的备注信息高级接口（2/friendships/friends/remark_batch）。

关系写入接口移除当前登录用户的粉丝高级接口（2/friendships/followers/destroy）。 2013-01-23

账号读取接口新增获取用户联系邮箱接口（2/account/profile/email），用于查询授权用户的联系邮箱。

该接口在调用前需用户在Scope授权页同意，才能被用户正常调用。scope详情见： 2012-12-20

即日起，微博开放平台将禁止“累计使用人数小于500,000”的应用使用V1接口。迁移指南： 2012-12-18

获取微博精选推荐接口（2/suggestions/statuses/hot），由于数据维护问题，已经下线，不再提供。 2012-11-07

即日起，使用开发者帐号授权自己的应用的授权（token）有效期延长为5年。

发布授权查询接口（Oauth2/get_token_info），用于应用查询已授权用户授权时间、过期时间和scope权限等授权相关信息。 2012-11-06

热门微博转发榜及评论榜相关接口，由于数据维护问题，已经下线，不再提供。包含：

2/statuses/hot/repost daily

2/statuses/hot/repost weekly

2/statuses/hot/comments daily

2/statuses/hot/comments weekly 2012-10-31

发布地图引擎接口，包含核心类、基础类、覆盖物类多个可用函数。详情见： 2012-10-26

发布好友分组读写高级接口，共18个。详情见：

发布微博标签读写高级接口，共7个。详情见：

发布置顶微博读写高级接口，共3个。详情见：

微博读取接口新增定向微博高级接口，共2个。详情见：

微博写入接口新增屏蔽微博高级接口，共2个。详情见：

用户读取接口新增获取用户等级信息接口，共1个。详情见：

好友分组、定向微博接口增加scope功能，具体为这些接口在调用前需用户在授权页同意，才能被用户正常调用。scope详情见： 2012-10-15

即日起，微博开放平台将禁止“累计使用人数小于10,000”的应用使用V1接口。迁移指南： 2012-08-27

即日起，微博开放平台将禁止所有“已通过文案审核，但累计使用人数小于1000”的应用使用V1接口，V2接口文档参考： 。新版接口迁移指南详细见： 2012-08-22

发布看点的视频上传接口，详细见： 2012-07-24

即日起，微博开放平台将禁止所有“未通过审核的应用”调用V1接口，V2接口文档参考： 2012-06-07

发布社交电视接口，包含微博互动读取、微博互动访问、节目相关信息、电视台列表等接口，详细见： 2012-05-28

发布基于地理位置服务的LBS开放接口，包含POI数据、签到、点评等一系列功能，详细见： 2012-04-24

发布短链开放接口二期，共7个接口，主要为短链数据、分析功能，详细见： 2012-03-22

发布短链开放接口一期，共3个接口，主要为短链转换功能，详细见： 2012-03-14

发布remind/set_count 对当前登录用户某一种消息未读数进行清零接口。 2012-02-24

发布search/topics 搜索某一话题下的微博接口，该接口为替换老的话题微博接口的升级版接口。 2011-12-28

接口trends/statuses，由于数据维护问题，已经下线，不再提供，稍后我们会开放新版的搜索话题接口，该接口功能更强大，更稳定，敬请期待。 2011-12-19

平台对接口：friendships/create 和 friendships/destroy 进行了升级，规范了其错误返回信息，有可能对您的应用产生影响，在此提醒您注意，新的错误返回信息详见： 2011-12-01

平台V2版接口，第二批开放接口已经上线并开放，详细接口请见： 2011-11-18

发布地图服务接口，location接口可以提供基础的地理、地图服务，详细接口请见： 2011-10-12

发布新版接口，新版接口性能更高效，授权机制更安全，详情请见： 2011-08-23

未读数提醒升级，现在发微博自己@自己将不再提醒未读，影响接口（statuses/unread）。

修复了评论接口（statuses/comment）的头像更新Bug，该Bug会引起收评论对象更新头像时，发出的评论中头像没有更新，同时影响的接口还包括微博回复评论接口（statuses/reply）。 2011-08-16

修复了未读数接口（statuses/unread）重复计数的bug，该bug会引起新粉丝重复计数。 2011-08-09

修复了回复评论接口（statuses/reply）的bug，该bug会引起回复自己的评论时会有新评论的未读数提醒，同时影响的接口还包括微博评论接口（statuses/comment）。

针对未通过审核的，开发中的应用，我们除了以上的频次限制外，将还有测试账号的额外请求限制。每个未通过审核应用只能授权15个测试账号来请求接口。除此之外的账号通过该应用，都无法请求接口。当应用通过审核，该限制自动取消。 测试账号设置在 “我的应用>编辑应用属性>测试账号” 里可以找到。

我们希望API调用者都能遵循请求限制，过度频率的调用API会导致你的应用/IP加入黑名单。加入黑名单之后，所有请求都会无任何返回。

首先微博API技术原理上是一个HTTP轮询(POLLING)协议，不是即时推送(realtime push)协议。因此即使增大刷新频率也无法完全达到即时获得最新信息效果。根据经验，更新频率我们建议2-3分钟/次为宜，API客户端也可提供一个手工刷新按钮，用户可以手工获取最新数据。 API客户端可以智能控制请求频率，比如最近几次更新都没获取到数据情况下可以适当将间隔时间延长。当一小时内剩余次数多时候可以适当将更新加快。当剩余请求数偏小时，客户端通过延长自己的更新频率控制不超过上限。另外要适当留一些空余指标，防止用户手工执行一些操作产生的调用导致超出上限。