statuses/followers

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

Returns the authenticating user's followers, each with current status inline. They are ordered by the order in which they followed the user, 100 at a time. (Please note that the result set isn't guaranteed to be 100 every time as suspended users will be filtered out.) Use the cursor option to access earlier followers.

URL

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

格式

xml, json

HTTP请求方式

GET

是否需要身份验证

false unless requesting it from a protected user; if getting this data of a protected user, you must auth (and be allowed to see that user).

请求数限制

1 call per request

请求参数

• id. 选填参数. 要获取粉丝的 UID或用户账户

o Example: 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 Example: http://api.t.sina.com.cn/statuses/followers.xml?user_id=1401881

• screen_name. 选填参数. 要获取的账户ID

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

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

o Example: http://api.t.sina.com.cn/statuses/followers/barackobama.xml?cursor=-1 o Example: http://api.t.sina.com.cn/statuses/followers/barackobama.xml?cursor=1300794057949944903

使用说明

• 为了保护用户隐私，只有用户设置了公开或对粉丝设置了公开的数据才会返回。

不分页返回

XML示例:

<?xml version="1.0" encoding="UTF-8"?>
<users>
 <user>
 <id>1401881</id>
 <name>Doug Williams</name>
 <screen_name>dougw</screen_name>
 <location>San Francisco, CA</location>
 <description>Sina API Support. Internet, greed, users, dougw and opportunities are my passions.</description>
 <profile_image_url></profile_image_url>
 <url>http://www.igudo.com</url>
 <protected>false</protected>
 <followers_count>1031</followers_count>
 <profile_background_color>9ae4e8</profile_background_color>
 <profile_text_color>000000</profile_text_color>
 <profile_link_color>0000ff</profile_link_color>
 <profile_sidebar_fill_color>e0ff92</profile_sidebar_fill_color>
 <profile_sidebar_border_color>87bc44</profile_sidebar_border_color>
 <friends_count>293</friends_count>
 <created_at>Sun Mar 18 06:42:26 +0000 2007</created_at>
 <favourites_count>0</favourites_count>
 <utc_offset>-18000</utc_offset>
 <time_zone>Eastern Time (US & Canada)</time_zone>
 
 <profile_background_tile>false</profile_background_tile>
 <statuses_count>3390</statuses_count>
 <notifications>false</notifications>
 <following>false</following>
 <verified>true</verified>
 <status>
  <created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>
  <id>1472669360</id>
  <text>At least I can get your humor through  I don't mean this in a bad way, but genetically speaking your a cul-de-sac.</text>
  <source><a href="http://t.sina.com.cn/">MSN机器人</a></source>
  <truncated>false</truncated>
  <in_reply_to_status_id></in_reply_to_status_id>
  <in_reply_to_user_id></in_reply_to_user_id>
  <favorited>false</favorited>
  <in_reply_to_screen_name></in_reply_to_screen_name>
 </status>
</user>
 ... truncated ...
</users> 

分页返回

XML示例:

<?xml version="1.0" encoding="UTF-8"?>
<users_list>
<users type="array">
<user>
 <id>422</id>
 <name>Jason Shellen</name>
 <screen_name>shellen</screen_name>
 <location>iPhone: 37.889321,-122.173345</location>
 <description>CEO and founder of Thing Labs, makers of Brizzly! Former Blogger/Google dude, father of two little dudes.</description>
 <profile_image_url></profile_image_url>
 <url>http://www.shellen.com</url>
 <protected>false</protected>
 <followers_count>8526</followers_count>
 <profile_background_color>9ae4e8</profile_background_color>
 <profile_text_color>000000</profile_text_color>
 <profile_link_color>0000ff</profile_link_color>
 <profile_sidebar_fill_color>DCDCDC</profile_sidebar_fill_color>
 <profile_sidebar_border_color>D22900</profile_sidebar_border_color>
 <friends_count>375</friends_count>
 <created_at>Thu Jul 06 22:36:22 +0000 2006</created_at>
 <favourites_count>1179</favourites_count>
 <utc_offset>-28800</utc_offset>
 <time_zone>Pacific Time (US & Canada)</time_zone>
 <profile_background_image_url></profile_background_image_url>
 <profile_background_tile>true</profile_background_tile>
 <statuses_count>2710</statuses_count>
 <notifications></notifications>
 <verified>false</verified>
 <following></following>
 <status>
   <created_at>Thu Sep 24 19:31:58 +0000 2009</created_at>
   <id>4349531340</id>
   <text>I think @jasonfried just went from "prickly fellow" to "kind of a dick" in my book. Eyes on your own paper Fried.</text>
   <source><a href="http://www.brizzly.com" rel="nofollow">Brizzly</a></source>
   <truncated>false</truncated>
   <in_reply_to_status_id></in_reply_to_status_id>
   <in_reply_to_user_id></in_reply_to_user_id>
   <favorited>false</favorited>
   <in_reply_to_screen_name></in_reply_to_screen_name>
 </status>
</user>
... truncated ... 
</users>
<next_cursor>1299072354878293926</next_cursor>
<previous_cursor>0</previous_cursor>

</users_list>

说明

• 如果没有提供cursor参数，将只返回最前面的100个关注列表

使用示例

cURL:

curl -u user:password http://api.t.sina.com.cn/statuses/followers.xml