API文档-

跳转到: 导航, 搜索

目录

API文档

注:点击查看 V1到V2接口迁移指南,查看 旧版接口文档

标识为 的接口为高级权限接口,需要申请才可以调用,申请方式请见 高级接口申请

标识为 的接口为需要单独向用户提出SCOPE授权请求的接口,用户单独授权后才可以调用,具体使用方法请见 scope


微博
读取接口 statuses/public_timeline 获取最新的公共微博
statuses/friends_timeline 获取当前登录用户及其所关注用户的最新微博
statuses/home_timeline 获取当前登录用户及其所关注用户的最新微博
statuses/friends_timeline/ids 获取当前登录用户及其所关注用户的最新微博的ID
statuses/user_timeline 获取用户发布的微博
statuses/user_timeline/ids 获取用户发布的微博的ID
statuses/timeline_batch 批量获取指定的一批用户的微博列表
statuses/repost_timeline 返回一条原创微博的最新转发微博
statuses/repost_timeline/ids 获取一条原创微博的最新转发微博的ID
statuses/mentions 获取@当前用户的最新微博
statuses/mentions/ids 获取@当前用户的最新微博的ID
statuses/bilateral_timeline 获取双向关注用户的最新微博
statuses/show 根据ID获取单条微博信息
statuses/show_batch 根据微博ID批量获取微博信息
statuses/querymid 通过id获取mid
statuses/queryid 通过mid获取id
statuses/count 批量获取指定微博的转发数评论数
statuses/to_me 获取当前登录用户关注的人发给其的定向微博
statuses/to_me/ids 获取当前登录用户关注的人发给其的定向微博ID列表
statuses/go 根据ID跳转到单条微博页
emotions 获取官方表情
写入接口 statuses/repost 转发一条微博信息
statuses/destroy 删除微博信息
statuses/update 发布一条微博信息
statuses/upload 上传图片并发布一条微博
statuses/upload_url_text 发布一条微博同时指定上传的图片或图片url
statuses/filter/create 屏蔽某条微博
statuses/mentions/shield 屏蔽某个@我的微博及后续由其转发引起的@提及
评论
读取接口 comments/show 获取某条微博的评论列表
comments/by_me 我发出的评论列表
comments/to_me 我收到的评论列表
comments/timeline 获取用户发送及收到的评论列表
comments/mentions 获取@到我的评论
comments/show_batch 批量获取评论内容
写入接口 comments/create 评论一条微博
comments/destroy 删除一条评论
comments/destroy_batch 批量删除评论
comments/reply 回复一条评论
用户
读取接口 users/show 获取用户信息
users/domain_show 通过个性域名获取用户信息
users/counts 批量获取用户的粉丝数、关注数、微博数
置顶微博
读取接口 users/get_top_status 获取用户主页置顶微博
写入接口 users/set_top_status 设置用户主页置顶微博
users/cancel_top_status 取消用户主页置顶微博
关系
关注读取接口 friendships/friends 获取用户的关注列表
friendships/friends/remark_batch 批量获取当前登录用户的关注人的备注信息
friendships/friends/in_common 获取共同关注人列表
friendships/friends/bilateral 获取双向关注列表
friendships/friends/bilateral/ids 获取双向关注UID列表
friendships/friends/ids 获取用户关注对象UID列表
粉丝读取接口 friendships/followers 获取用户粉丝列表
friendships/followers/ids 获取用户粉丝UID列表
friendships/followers/active 获取用户优质粉丝列表
关系链读取接口 friendships/friends_chain/followers 获取我的关注人中关注了指定用户的人
关系读取接口 friendships/show 获取两个用户关系的详细情况
写入接口 friendships/create 关注某用户
friendships/destroy 取消关注某用户
friendships/followers/destroy 移除当前登录用户的粉丝
friendships/remark/update 更新关注人备注
好友分组
读取接口 friendships/groups 获取当前登陆用户好友分组列表
friendships/groups/timeline 获取某一好友分组的微博列表
friendships/groups/timeline/ids 获取某一好友分组的微博ID列表
friendships/groups/members 获取某一好友分组下的成员列表
friendships/groups/members/ids 获取某一好友分组下的成员列表的ID
friendships/groups/members/description 批量取好友分组成员的分组说明
friendships/groups/is_member 判断某个用户是否是指定好友分组内的成员
friendships/groups/listed 批量获取某些用户在指定用户的好友分组中的收录信息
friendships/groups/show 获取某个分组的详细信息
friendships/groups/show_batch 批量获取好友分组的详细信息
写入接口 friendships/groups/create 创建好友分组
friendships/groups/update 更新好友分组
friendships/groups/destroy 删除好友分组
friendships/groups/members/add 添加关注用户到好友分组
friendships/groups/members/add_batch 批量添加用户到好友分组
friendships/groups/members/update 更新好友分组中成员的分组说明
friendships/groups/members/destroy 删除好友分组内的关注用户
friendships/groups/order 调整当前登录用户的好友分组顺序
账号
读取接口 account/get_privacy 获取隐私设置信息
account/profile/school_list 获取所有学校列表
account/rate_limit_status 获取当前用户API访问频率限制
account/profile/email 获取用户的联系邮箱
account/get_uid OAuth授权之后获取用户UID(作用相当于旧版接口的 account/verify_credentials
写入接口 account/end_session 退出登录
收藏
读取接口 favorites 获取当前用户的收藏列表
favorites/ids 获取当前用户的收藏列表的ID
favorites/show 获取单条收藏信息
favorites/by_tags 获取当前用户某个标签下的收藏列表
favorites/tags 当前登录用户的收藏标签列表
favorites/by_tags/ids 获取当前用户某个标签下的收藏列表的ID
写入接口 favorites/create 添加收藏
favorites/destroy 删除收藏
favorites/destroy_batch 批量删除收藏
favorites/tags/update 更新收藏标签
favorites/tags/update_batch 更新当前用户所有收藏下的指定标签
favorites/tags/destroy_batch 删除当前用户所有收藏下的指定标签
话题
读取接口 trends/hourly 返回最近一小时内的热门话题
trends/daily 返回最近一天内的热门话题
trends/weekly 返回最近一周内的热门话题
微博标签
读取接口 statuses/tags 获取用户的微博标签列表
statuses/tags/show_batch 批量获取微博标签
statuses/tag_timeline/ids 获取用户某个标签的微博ID列表
写入接口 statuses/tags/create 创建标签
statuses/tags/destroy 删除标签
statuses/tags/update 更新标签
statuses/update_tags 更新某个微博的标签
用户标签
读取接口 tags 返回指定用户的标签列表
tags/tags_batch 批量获取用户标签
tags/suggestions 返回系统推荐的标签列表
写入接口 tags/create 添加用户标签
tags/destroy 删除用户标签
tags/destroy_batch 批量删除用户标签
注册
读取接口 register/verify_nickname 验证昵称是否可用
搜索
搜索联想接口 search/suggestions/users 搜用户搜索建议
search/suggestions/schools 搜学校搜索建议
search/suggestions/companies 搜公司搜索建议
search/suggestions/apps 搜应用搜索建议
search/suggestions/at_users @联想搜索
搜索话题接口 search/topics 搜索某一话题下的微博
推荐
读取接口 suggestions/users/hot 获取系统推荐用户
suggestions/users/may_interested 获取用户可能感兴趣的人
suggestions/users/by_status 根据微博内容推荐用户
suggestions/statuses/reorder 主Feed微博按兴趣推荐排序
suggestions/statuses/reorder/ids 主Feed微博按兴趣推荐排序的微博ID
suggestions/favorites/hot 热门收藏
写入接口 suggestions/users/not_interested 不感兴趣的人
提醒
读取接口 remind/unread_count 获取某个用户的各种消息未读数
写入接口 remind/set_count 对当前登录用户某一种消息未读数进行清零
短链
转换接口 short_url/shorten 长链转短链
short_url/expand 短链转长链
数据接口 short_url/share/counts 获取短链接在微博上的微博分享数
short_url/share/statuses 获取包含指定单个短链接的最新微博内容
short_url/comment/counts 获取短链接在微博上的微博评论数
short_url/comment/comments 获取包含指定单个短链接的最新微博评论
通知
发送接口 notification/send 给一个或多个用户发送一条新的状态通知
公共服务
读取接口 common/code_to_location 通过地址编码获取地址名称
common/get_city 获取城市列表
common/get_province 获取省份列表
common/get_country 获取国家列表
common/get_timezone 获取时区配置表
位置服务(开发指南
动态读取接口 place/public_timeline 获取公共的位置动态
place/friends_timeline 获取用户好友的位置动态
place/user_timeline 获取某个用户的位置动态
place/poi_timeline 获取某个位置地点的动态
place/nearby_timeline 获取某个位置周边的动态
place/statuses/show 获取动态的详情
用户读取接口 place/users/show 获取LBS位置服务内的用户信息
place/users/checkins 获取用户签到过的地点列表
place/users/photos 获取用户的照片列表
place/users/tips 获取用户的点评列表
place/users/todos 获取用户的todo列表
地点读取接口 place/pois/show 获取地点详情
place/pois/users 获取在某个地点签到的人的列表
place/pois/tips 获取地点点评列表
place/pois/photos 获取地点照片列表
place/pois/search 按省市查询地点
place/pois/category 获取地点分类
附近读取接口 place/nearby/pois 获取附近地点
place/nearby/users 获取附近发位置微博的人
place/nearby/photos 获取附近照片
place/nearby_users/list 获取附近的人
地点写入接口 place/pois/create 添加地点
place/pois/add_checkin 签到
place/pois/add_photo 添加照片
place/pois/add_tip 添加点评
place/pois/add_todo 添加todo
附近写入接口 place/nearby_users/create 用户添加自己的位置
place/nearby_users/destroy 用户删除自己的位置
地理信息
基础位置读取接口 location/base/get_map_image 生成一张静态的地图图片
坐标转换接口 location/geo/ip_to_geo 根据IP地址返回地理信息坐标
location/geo/address_to_geo 根据实际地址返回地理信息坐标
location/geo/geo_to_address 根据地理信息坐标返回实际地址
location/geo/gps_to_offset 根据GPS坐标获取偏移后的坐标
location/geo/is_domestic 判断地理信息坐标是否是国内坐标
POI数据搜索接口 location/pois/search/by_location 根据关键词按地址位置获取POI点的信息
location/pois/search/by_geo 根据关键词按坐标点范围获取POI点的信息
location/pois/search/by_area 根据关键词按矩形区域获取POI点的信息
POI数据读写接口 location/pois/show_batch 批量获取POI点的信息
location/pois/add 提交一个新增的POI点信息
移动服务读取接口 location/mobile/get_location 根据移动基站WIFI等数据获取当前位置信息
交通路线读取接口 location/line/drive_route 根据起点与终点数据查询自驾车路线信息
location/line/bus_route 根据起点与终点数据查询公交乘坐路线信息
location/line/bus_line 根据关键词查询公交线路信息
location/line/bus_station 根据关键词查询公交站点信息
地理信息字段说明 location/citycode 城市代码对应表
location/citycode_bus 公交城市代码表
location/category 分类代码对应表
location/error2 地理位置信息接口错误代码及解释


OAuth2(开发指南
请求授权 oauth2/authorize 请求用户授权Token
获取授权 oauth2/access_token 获取授权过的Access Token
授权查询 oauth2/get_token_info 查询用户access_token的授权相关信息
替换授权 oauth2/get_oauth2_token OAuth1.0的Access Token更换至OAuth2.0的Access Token
授权回收 OAuth2/revokeoauth2 授权回收接口,帮助开发者主动取消用户的授权