新浪微博 SDK API文档

API文档

重要：新创建应用需要通过审核必须使用OAuth2.0和新版接口。 新版接口迁移指南新版接口文档 OAuth2.0开发指南

微博基础数据接口 (Rest API)

获取下行数据集(timeline)接口

• statuses/public_timeline 获取最新的公共微博消息
• statuses/friends_timeline 获取当前登录用户及其所关注用户的最新微博消息 (别名: statuses/home_timeline)
• statuses/user_timeline 获取用户发布的微博消息列表
• statuses/mentions 获取@当前用户的微博列表
• statuses/comments_timeline 获取当前用户发送及收到的评论列表
• statuses/comments_by_me 获取当前用户发出的评论
• statuses/comments_to_me 获取当前用户收到的评论
• statuses/comments 根据微博消息ID返回某条微博消息的评论列表
• statuses/counts 批量获取一组微博的评论数及转发数
• statuses/repost_timeline 返回一条原创微博的最新n条转发微博信息 New!
• statuses/repost_by_me 返回用户转发的最新n条微博信息 New!
• statuses/unread 获取当前用户未读消息数
• statuses/reset_count 未读消息数清零接口
• emotions 表情接口，获取表情列表

微博访问接口

• statuses/show 根据ID获取单条微博信息内容
• user/statuses/id 根据微博ID和用户ID跳转到单条微博页面
• statuses/update 发布一条微博信息Updated!
• statuses/upload 上传图片并发布一条微博信息
• statuses/destroy 删除一条微博信息
• statuses/repost 转发一条微博信息Updated!
• statuses/comment 对一条微博信息进行评论Updated!
• statuses/comment_destroy/:id 删除当前用户的微博评论信息
• statuses/comment/destroy_batch 批量删除当前用户的微博评论信息
• statuses/reply 回复微博评论信息Updated!

用户接口

• users/show 根据用户ID获取用户资料（授权用户）

• statuses/friends 获取用户关注列表及每个关注用户最新一条微博
• statuses/followers 获取用户粉丝列表及及每个粉丝用户最新一条微博
• users/hot 获取系统推荐用户
• user/friends/update_remark更新当前登录用户所关注的某个好友的备注信息New!
• users/suggestions 返回当前用户可能感兴趣的用户 Beta!

关注接口

• friendships/create 关注某用户
• friendships/destroy 取消关注
• friendships/exists 是否关注某用户(推荐使用friendships/show)
• friendships/show 获取两个用户关系的详细情况

话题接口Beta!

• trends 获取某人的话题
• trends/statuses 获取某一话题下的微博
• trends/follow 关注某一个话题
• trends/destroy 取消关注的某一个话题
• trends/hourly 按小时返回热门话题
• trends/daily 返回当日热门话题。
• trends/weekly 返回当周热门话题。

Social Graph接口

• friends/ids 获取用户关注对象uid列表
• followers/ids 获取用户粉丝对象uid列表

隐私设置接口[NEW]

• account/update_privacy 设置隐私信息
• account/get_privacy 获取隐私信息

黑名单接口 [NEW]

• blocks/create 将某用户加入黑名单
• blocks/destroy 将某用户移出黑名单
• blocks/exists 检测某用户是否是黑名单用户
• blocks/blocking 列出黑名单用户(输出用户详细信息)
• blocks/blocking/ids 列出分页黑名单用户（只输出id）

用户标签接口[NEW]

• tags 返回指定用户的标签列表
• tags/create 添加用户标签
• tags/suggestions 返回用户感兴趣的标签
• tags/destroy 删除标签
• tags/destroy_batch 批量删除标签

账号接口

• account/verify_credentials 验证当前用户身份是否合法
• account/rate_limit_status 获取当前用户API访问频率限制
• account/end_session 当前用户退出登录
• account/update_profile_image 更改头像
• account/update_profile 更改资料

收藏接口

• favorites 获取当前用户的收藏列表
• favorites/create 添加收藏
• favorites/destroy 删除当前用户收藏的微博信息
• favorites/destroy_batch 批量删除收藏的微博信息

短链接口 [NEW]

• short_url/shorten 将一个或多个长链接转换成短链接
• short_url/expand 将一个或多个短链接还原成原始的长链接
• short_url/share/counts 取得一个短链接在微博上的微博分享数（包含原创和转发的微博）
• short_url/share/statuses 取得包含指定单个短链接的最新微博内容
• short_url/comment/counts 取得一个短链接在微博上的微博评论数
• short_url/comment/comments 取得包含指定单个短链接的最新微博评论内容

登录/OAuth接口

• oauth OAuth授权方式介绍
• oauth/request_token 获取未授权的Request Token
• oauth/authorize 请求用户授权Token
• oauth/access_token 获取授权过的Access Token

登录/OAuth 2.0接口

• OAuth2/access_token 获取授权过的Access Token
• Oauth2/authorize 请求用户授权Token

微博地理位置信息接口

有任何问题，请联系 @新浪地图

地图引擎接口[NEW]

• Map-JS 是一套由JS语言编写的地图引擎，您可以用它在网站中构建功能丰富、交互性强的地图应用

POI数据搜索接口[NEW]

• pois/keyword 根据关键字和（或）分类进行搜索，返回相关的poi点信息
• pois/round 根据关键字和（或）分类，在中心点附近搜索，返回相关的poi点信息
• pois/view 根据关键字和（或）分类，在一个矩形里进行搜索，返回相关的poi点信息

POI数据处理接口[NEW]

• pois/add_poi 新增POI数据
• pois/get_poi 获取新增POI数据

移动定位接口[NEW]

• loc/get_location 根据基站、WIFI等其它数据，返回当前位置

地址转换接口[NEW]

• geocode/ip_to_geo 根据ip返回地理信息
• geocode/address_to_geo 根据地址返回坐标的接口
• geocode/geo_to_address 根据坐标返回地址信息

驾车路线搜索接口[NEW]

• navigation/route 驾车路线查询

公交搜索接口[NEW]

• bus/transfer 根据起始id或坐标搜索公交换乘路线
• bus/line 线路名称搜索
• bus/station 公交站点名称搜索

空间计算接口[NEW]

• distance/distance_point 计算地图上两点之间的距离
• distance/distance_po_li 计算地图上（x，y）到线的最近距离
• distance/distance_line 计算地图上线的长度

静态地图接口[NEW]

• base/get_map_image生成一个静态地图的图片

地理位置信息接口错误代码及解释

• location/error 地理位置信息接口错误代码及解释

测试接口

• help/test 测试接口

附录

Rest API字段说明

• status 微博信息内容
• user 用户资料信息
• comment 评论信息描述
• direct_message 私信信息
• 省份城市编码表
• Metadata 元数据 New!

地理信息字段说明

• location/citycode 城市代码对应表
• location/citycode_bus 公交城市代码表
• location/category 分类代码对应表