Weibo Platform Logo

微博开放平台

weibo

Statuses/followers

跳转到： 导航, 搜索

目录

statuses/followers

返回用户的粉丝列表，并返回粉丝的最新微博。按粉丝的关注时间倒序返回，每次返回100个,通过cursor参数来取得多于100的粉丝。注意目前接口最多只返回5000个粉丝。

URL

http://api.t.sina.com.cn/statuses/followers.format

格式

xml, json

HTTP请求方式

GET

是否需要身份验证

true

请求数限制

true

请求参数

  • id. 选填参数. 要获取粉丝的 UID或微博昵称

o 示例: http://api.t.sina.com.cn/statuses/followers/12345.json or http://api.t.sina.com.cn/statuses/followers/bob.xml

  • user_id. 选填参数. 要获取的UID

o 示例: http://api.t.sina.com.cn/statuses/followers.xml?user_id=1401881

  • screen_name. 选填参数. 要获取的微博昵称

o 示例: http://api.t.sina.com.cn/statuses/followers.xml?screen_name=101010

  • cursor. 选填参数. 单页只能包含100个粉丝列表，为了获取更多则cursor默认从-1开始，通过增加或减少cursor来获取更多的，如果没有下一页，则next_cursor返回0

粉丝列表 o 示例: http://api.t.sina.com.cn/statuses/followers/barackobama.xml?cursor=-1 o 示例: http://api.t.sina.com.cn/statuses/followers/barackobama.xml?cursor=1300794057949944903

  • count. 可选参数. 每次返回的最大记录数（即页面大小），不大于200,默认返回20。

o 示例: http://api.t.sina.com.cn/statuses/followers/bob.xml?&count=200

使用说明

  • 为了保护用户隐私，只有用户设置了公开或对粉丝设置了公开的数据才会返回。
  • 如果没有提供cursor参数，将只返回最前面的100个关注列表

返回结果

XML

<?xml version="1.0" encoding="UTF-8"?>
<users>
  <user>
    <id>1644917462</id>
    <screen_name>大竹006</screen_name>
    <name>大竹006</name>
    <province>11</province>
    <city>1000</city>
    <location>北京</location>
    <description/>
    <url/>
    <profile_image_url>http://tp3.sinaimg.cn/1644917462/50/0</profile_image_url>
    <domain/>
    <gender>m</gender>
    <followers_count>0</followers_count>
    <friends_count>19</friends_count>
    <statuses_count>0</statuses_count>
    <favourites_count>0</favourites_count>
    <created_at>Mon Sep 13 00:00:00 +0800 2010</created_at>
    <following>false</following>
    <verified>false</verified>
    <allow_all_act_msg>false</allow_all_act_msg>
    <geo_enabled>false</geo_enabled>
  </user>
  <user>
    <id>1819424053</id>
    <screen_name>Kevinssolo</screen_name>
    <name>Kevinssolo</name>
    <province>11</province>
    <city>5</city>
    <location>北京 朝阳区</location>
    <description/>
    <url/>
    <profile_image_url>http://tp2.sinaimg.cn/1819424053/50/0</profile_image_url>
    <domain>kevinssolo</domain>
    <gender>m</gender>
    <followers_count>0</followers_count>
    <friends_count>20</friends_count>
    <statuses_count>1</statuses_count>
    <favourites_count>0</favourites_count>
    <created_at>Mon Sep 13 00:00:00 +0800 2010</created_at>
    <following>false</following>
    <verified>false</verified>
    <allow_all_act_msg>false</allow_all_act_msg>
    <geo_enabled>false</geo_enabled>
    <status>
      <created_at>Mon Sep 13 17:52:38 +0800 2010</created_at>
      <id>2591178727</id>
      <text>为了显示自己还在时尚这圈子里混被注册了微博，不会用，先注册了再说，省的好名字被抢，同时也能提醒自己还没老！[鄙视]</text>
      <source>
        <a href="http://t.sina.com.cn">新浪微博</a>
      </source>
      <favorited>false</favorited>
      <truncated>false</truncated>
      <geo/>
      <in_reply_to_status_id/>
      <in_reply_to_user_id/>
      <in_reply_to_screen_name/>
    </status>
  </user>
  <next_cursor>2</next_cursor>  //仅在带了cursor参数后才有此字段
  <previous_cursor>0</previous_cursor>  //仅在带了cursor参数后才有此字段
</users>

JSON

{
   "users":[
      {
         "id":1644917462,
         "screen_name":"大竹006",
         "name":"大竹006",
         "province":"11",
         "city":"1000",
         "location":"北京",
         "description":"",
         "url":"",
         "profile_image_url":"http://tp3.sinaimg.cn/1644917462/50/0",
         "domain":"",
         "gender":"m",
         "followers_count":0,
         "friends_count":19,
         "statuses_count":0,
         "favourites_count":0,
         "created_at":"Mon Sep 13 00:00:00 +0800 2010",
         "following":false,
         "allow_all_act_msg":false,
         "geo_enabled":false,
         "verified":false
      },
      {
         "id":1819424053,
         "screen_name":"Kevinssolo",
         "name":"Kevinssolo",
         "province":"11",
         "city":"5",
         "location":"北京 朝阳区",
         "description":"",
         "url":"",
         "profile_image_url":"http://tp2.sinaimg.cn/1819424053/50/0",
         "domain":"kevinssolo",
         "gender":"m",
         "followers_count":0,
         "friends_count":20,
         "statuses_count":1,
         "favourites_count":0,
         "created_at":"Mon Sep 13 00:00:00 +0800 2010",
         "following":false,
         "allow_all_act_msg":false,
         "geo_enabled":false,
         "verified":false,
         "status":{
            "created_at":"Mon Sep 13 17:52:38 +0800 2010",
            "id":2591178727,
            "text":"为了显示自己还在时尚这圈子里混被注册了微博，不会用，先注册了再说，省的好名字被抢，同时也能提醒自己还没老！[鄙视]",
            "source":"<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>",
            "favorited":false,
            "truncated":false,
            "in_reply_to_status_id":"",
            "in_reply_to_user_id":"",
            "in_reply_to_screen_name":"",
            "geo":null
         }
      }
   ],
   "next_cursor":2,  //仅在带了cursor参数后才有此字段
   "previous_cursor":0  //仅在带了cursor参数后才有此字段
}

字段说明 - user

  • id: 用户UID
  • screen_name: 微博昵称
  • name: 友好显示名称，同微博昵称
  • province: 省份编码（参考省份编码表）
  • city: 城市编码（参考城市编码表）
  • location：地址
  • description: 个人描述
  • url: 用户博客地址
  • profile_image_url: 自定义图像
  • domain: 用户个性化URL
  • gender: 性别,m--男，f--女,n--未知
  • followers_count: 粉丝数
  • friends_count: 关注数
  • statuses_count: 微博数
  • favourites_count: 收藏数
  • created_at: 创建时间
  • following: 是否已关注(此特性暂不支持)
  • verified: 加V标示，是否微博认证用户

字段说明 - status

  • created_at: 创建时间
  • id: 微博ID
  • text: 微博信息内容
  • source: 微博来源
  • favorited: 是否已收藏
  • truncated: 是否被截断
  • in_reply_to_status_id: 回复ID
  • in_reply_to_user_id: 回复人UID
  • in_reply_to_screen_name: 回复人昵称
  • thumbnail_pic: 缩略图
  • bmiddle_pic: 中型图片
  • original_pic：原始图片
  • user: 作者信息
  • retweeted_status: 转发的博文，内容为status，如果不是转发，则没有此字段

使用示例

  • xml:

curl -u uid:password http://api.t.sina.com.cn/statuses/followers.xml?source=appkey

  • json:

curl -u uid:password http://api.t.sina.com.cn/statuses/followers.json?source=appkey

Java示例

请从 微博SDK开发包下载 下载Java SDK
代码示例如下: 

package weibo4j.examples;

import java.util.List;
import weibo4j.User;
import weibo4j.Weibo;
import weibo4j.WeiboException;

public class GetFollowers {

	/**
	 * 返回用户关注对象列表，并返回最新微博文章。
	 * @param args
	 */
	public static void main(String[] args) {
		System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
    	System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
	 	try {
			Weibo weibo = getWeibo(false,args);
			List<User> list = weibo.getFollowersStatuses();
			for(User user : list) {
				System.out.println(user.toString());
			}
		} catch (WeiboException e) {
			e.printStackTrace();
		}
	}
	
	private static Weibo getWeibo(boolean isOauth,String[] args) {
		Weibo weibo = new Weibo();
		if(isOauth) {//oauth验证方式 args[0]:访问的token；args[1]:访问的密匙
			weibo.setToken(args[0], args[1]);
		}else {//用户登录方式
    		weibo.setUserId(args[0]);//用户名/ID
    		weibo.setPassword(args[1]);//密码
		}
		return weibo;
	}
}

PHP示例

请从 微博SDK开发包下载 处下载PHP SDK（支持OAuth验证之版本）
代码示例如下: 

//Statuses/followers
//返回用户关注对象列表，并返回最新微博文章。
$c = new WeiboClient( WB_AKEY , 
                      WB_SKEY , 
                      $_SESSION['last_key']['oauth_token'] , 
                      $_SESSION['last_key']['oauth_token_secret']  );

//用户ID
$u_id = "u_id";
$msg = $c->followers(false, false, $u_id);
if ($msg === false || $msg === null){
	echo "Error occured";
	return false;
}
if (isset($msg['error_code']) && isset($msg['error'])){
	echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
	return false;
}
foreach($msg as $follower){
	echo($follower['id'].' : '.$follower['name'].'  '.$follower['created_at'].' ;');
}
来自“http://open.weibo.com/wiki/index.php?title=Statuses/followers&oldid=1998”

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA