Weibo Platform Logo

微博开放平台

weibo

Statuses/followers

跳转到： 导航, 搜索
(→statuses/followers)
第1行： 第1行：
 
== statuses/followers ==
 
== statuses/followers ==
−
返回登陆用户的粉丝列表，并返回粉丝的最新微薄文章。按粉丝的关注时间倒序返回，每次返回100个,通过cursor参数来取得多于100的粉丝。
+
返回用户的粉丝列表，并返回粉丝的最新微博。按粉丝的关注时间倒序返回，每次返回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.
 
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: ===
+
=== URL===
 
curl http://api.t.sina.com.cn/statuses/followers.format
 
curl http://api.t.sina.com.cn/statuses/followers.format
 
   
 
   
−
=== Formats:  ===
+
=== 格式===
 
xml, json
 
xml, json
 
   
 
   
−
=== HTTP Method(s): ===
+
=== HTTP请求方式===
 
GET
 
GET
 
   
 
   
−
=== Requires Authentication (about authentication): ===
+
=== 是否需要身份验证===
 
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).
 
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).
 
   
 
   
−
=== API rate limited (about rate limiting): ===
+
=== 请求数限制===
 
1 call per request
 
1 call per request
  
−
=== Parameters: ===
+
=== 请求参数===
 
* id.  选填参数.  要获取粉丝的 UID或用户账户   
 
* 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  
 
o Example: http://api.t.sina.com.cn/statuses/followers/12345.json or http://api.t.sina.com.cn/statuses/followers/bob.xml  
第30行： 第30行：
 
o Example: http://api.t.sina.com.cn/statuses/followers/barackobama.xml?cursor=1300794057949944903  
 
o Example: http://api.t.sina.com.cn/statuses/followers/barackobama.xml?cursor=1300794057949944903  
  
−
* id.  Optional.  The ID or screen name of the user for whom to request a list of followers. 
 
−
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.  Optional.  Specfies the ID of the user for whom to return the list of followers. Helpful for disambiguating when a valid user ID is also a valid screen name.
 
−
o Example: http://api.t.sina.com.cn/statuses/followers.xml?user_id=1401881
 
−
* screen_name.  Optional.  Specfies the screen name of the user for whom to return the list of followers. Helpful for disambiguating when a valid screen name is also a user ID.
 
−
o Example: http://api.t.sina.com.cn/statuses/followers.xml?screen_name=101010
 
−
* cursor. Optional. Breaks the results into pages. A single page contains 100 users. This is recommended for users who are followed by many other users. Provide a value of  -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
 
−
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
 
  
−
=== Usage Notes: ===
+
=== 使用说明===
 
* 为了保护用户隐私，只有用户设置了公开或对粉丝设置了公开的数据才会返回。
 
* 为了保护用户隐私，只有用户设置了公开或对粉丝设置了公开的数据才会返回。
−
* [Deprecation] 接口已过期，采用/friendships/show or /friendships/exists 接口替代
 
−
 
−
* Requests for protected users without credentials from 1) the user requested or 2) a user that is following the protected user will omit the nested status element. Only publicly available data will be returned in this case.
 
−
* [Deprecation] The notifications and following attributes will be removed in version 2 of the API. Use /friendships/show or /friendships/exists instead.
 
  
−
=== Unpaginated Response ===
+
=== 不分页返回 ===
−
(about return values): XML example (truncated):
+
XML示例:
 
  <?xml version="1.0" encoding="UTF-8"?>
 
  <?xml version="1.0" encoding="UTF-8"?>
 
  <users>
 
  <users>
第56行： 第43行：
 
   <screen_name>dougw</screen_name>
 
   <screen_name>dougw</screen_name>
 
   <location>San Francisco, CA</location>
 
   <location>San Francisco, CA</location>
−
   <description>Twitter API Support. Internet, greed, users, dougw and opportunities are my passions.</description>
+
   <description>Sina API Support. Internet, greed, users, dougw and opportunities are my passions.</description>
−
   <profile_image_url>http://s3.amazonaws.com/twitter_production/profile_images/59648642/avatar_normal.png</profile_image_url>
+
   <profile_image_url>http://sinaimg.cn/avatar.png</profile_image_url>
 
   <url>http://www.igudo.com</url>
 
   <url>http://www.igudo.com</url>
 
   <protected>false</protected>
 
   <protected>false</protected>
第71行： 第58行：
 
   <utc_offset>-18000</utc_offset>
 
   <utc_offset>-18000</utc_offset>
 
   <time_zone>Eastern Time (US & Canada)</time_zone>
 
   <time_zone>Eastern Time (US & Canada)</time_zone>
−
   <profile_background_image_url>http://s3.amazonaws.com/twitter_production/profile_background_images/2752608/twitter_bg_grass.jpg</profile_background_image_url>
+
    
 
   <profile_background_tile>false</profile_background_tile>
 
   <profile_background_tile>false</profile_background_tile>
 
   <statuses_count>3390</statuses_count>
 
   <statuses_count>3390</statuses_count>
第80行： 第67行：
 
   <created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>
 
   <created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>
 
   <id>1472669360</id>
 
   <id>1472669360</id>
−
   <text>At least I can get your humor through tweets. RT @abdur: I don't mean this in a bad way, but genetically speaking your a cul-de-sac.</text>
+
   <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://www.tweetdeck.com/">TweetDeck</a></source>
+
   <source><a href="http://t.sina.com.cn/">MSN机器人</a></source>
 
   <truncated>false</truncated>
 
   <truncated>false</truncated>
 
   <in_reply_to_status_id></in_reply_to_status_id>
 
   <in_reply_to_status_id></in_reply_to_status_id>
第92行： 第79行：
 
  </users>  
 
  </users>  
  
−
=== Paginated Response ===
+
=== 分页返回 ===
−
(about return values): XML example (truncated):
+
XML示例:
 
  <?xml version="1.0" encoding="UTF-8"?>
 
  <?xml version="1.0" encoding="UTF-8"?>
 
  <users_list>
 
  <users_list>
第103行： 第90行：
 
   <location>iPhone: 37.889321,-122.173345</location>
 
   <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>
 
   <description>CEO and founder of Thing Labs, makers of Brizzly! Former Blogger/Google dude, father of two little dudes.</description>
−
   <profile_image_url>http://a3.twimg.com/profile_images/369449595/js_glasses_suit_normal.png</profile_image_url>
+
   <profile_image_url>http://sinaimg.cn/avatar.png</profile_image_url>
 
   <url>http://www.shellen.com</url>
 
   <url>http://www.shellen.com</url>
 
   <protected>false</protected>
 
   <protected>false</protected>
第139行： 第126行：
 
  <next_cursor>1299072354878293926</next_cursor>
 
  <next_cursor>1299072354878293926</next_cursor>
 
  <previous_cursor>0</previous_cursor>
 
  <previous_cursor>0</previous_cursor>
−
    </users_list>  
+
</users_list>  
  
−
=== Notes: ===
+
=== 说明===
 
* 如果没有提供cursor参数，将只返回最前面的100个关注列表
 
* 如果没有提供cursor参数，将只返回最前面的100个关注列表
−
* 先前记录页的分页机制仍然存在，但会过时。请迁移到基cursor分页来提高可靠性和性能。
 
−
 
−
* If the cursor parameter is not provided, only the first 100 users in the set will be returned.
 
−
* The previously documented page-based pagination mechanism is still in production, but will be deprecated. Please migrate to cursor-based pagination for increased reliability and performance.
 
  
−
=== Usage examples: ===
+
=== 使用示例===
−
cURL (about cURL):
+
cURL:
  
 
curl -u user:password http://api.t.sina.com.cn/statuses/followers.xml
 
curl -u user:password http://api.t.sina.com.cn/statuses/followers.xml

2009年11月13日 (五) 18:00的版本

目录

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>avatar.png</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>avatar.png</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>IMG_0158.jpg</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

来自“http://open.weibo.com/wiki/index.php?title=Statuses/followers&oldid=206”

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

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