<< Back to Twitter API Documentation

 

Twitter REST API Method: GET /:user/:list_id/members

Returns the members of the specified list.

URL:

http://api.twitter.com/1/user/list_id/members.format

 

Formats: 

xml, json

 

HTTP Method(s):

GET

 

Requires Authentication (about authentication):

true

 

API rate limited (about rate limiting):

true

 

Parameters:

• list_id.  Required. The id or slug of the list.
• cursor. Optional. Breaks the results into pages. A single page contains 20 lists. 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.
  • Example: http://api.twitter.com/1/twitterapi/team/members.xml?cursor=-1
  • Example: http://api.twitter.com/1/twitterapi/team/members.xml?cursor=-1300794057949944903

 

Usage examples:

cURL (about cURL):

curl -u user:password http://api.twitter.com/1/twitterapi/team/members.xml

 

Response (about return values): 

XML example:

<?xml version="1.0" encoding="UTF-8"?>

<users_list>

<users type="array">

<user>

  <id>9160152</id>

  <name>Mark McBride</name>

  <screen_name>mccv</screen_name>

  <location>Santa Clara</location>

  <description>Developer, Student, Manager</description>

  <profile_image_url>http://a3.twimg.com/profile_images/489688167/profile_normal.png</profile_image_url>

  <url>http://themcwongs.com</url>

  <protected>false</protected>

  <followers_count>481</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>157</friends_count>

  <created_at>Sat Sep 29 16:10:54 +0000 2007</created_at>

  <favourites_count>0</favourites_count>

  <utc_offset>-28800</utc_offset>

  <time_zone>Pacific Time (US & Canada)</time_zone>

  <profile_background_image_url>http://s.twimg.com/a/1257288876/images/themes/theme1/bg.png</profile_background_image_url>

  <profile_background_tile>false</profile_background_tile>

  <statuses_count>1111</statuses_count>

  <notifications></notifications>

  <geo_enabled>false</geo_enabled>

  <verified>false</verified>

  <following></following>

  <status>

    <created_at>Wed Nov 04 18:28:02 +0000 2009</created_at>

    <id>5426714045</id>

    <text>Asking dumb Ruby Proc questions.  Typical day.</text>

    <source><a href="http://www.tweetdeck.com/" rel="nofollow">TweetDeck</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>

    <geo/>

  </status>

</user>

<user>

  <id>15266205</id>

  <name>Wilhelm Bierbaum</name>

  <screen_name>wilhelmbierbaum</screen_name>

  <location>Emeryville, California</location>

  <description></description>

  <profile_image_url>http://a1.twimg.com/profile_images/295905718/n665325681_602456_1182_normal.jpg</profile_image_url>

  <url></url>

  <protected>false</protected>

  <followers_count>375</followers_count>

  <profile_background_color>1A1B1F</profile_background_color>

  <profile_text_color>666666</profile_text_color>

  <profile_link_color>2FC2EF</profile_link_color>

  <profile_sidebar_fill_color>252429</profile_sidebar_fill_color>

  <profile_sidebar_border_color>181A1E</profile_sidebar_border_color>

  <friends_count>63</friends_count>

  <created_at>Sat Jun 28 21:40:02 +0000 2008</created_at>

  <favourites_count>15</favourites_count>

  <utc_offset>-28800</utc_offset>

  <time_zone>Pacific Time (US & Canada)</time_zone>

  <profile_background_image_url>http://s.twimg.com/a/1257288876/images/themes/theme9/bg.gif</profile_background_image_url>

  <profile_background_tile>false</profile_background_tile>

  <statuses_count>143</statuses_count>

  <notifications>false</notifications>

  <geo_enabled>false</geo_enabled>

  <verified>false</verified>

  <following>false</following>

  <status>

    <created_at>Wed Nov 04 21:55:36 +0000 2009</created_at>

    <id>5431539004</id>

    <text>recently discovered by poor completion: falseunctions</text>

    <source><a href="http://www.atebits.com/" rel="nofollow">Tweetie</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>

    <geo/>

  </status>

</user>

<user>

  <id>3191321</id>

  <name>Marcel Molina</name>

  <screen_name>noradio</screen_name>

  <location>San Francisco, CA</location>

  <description>Engineer at Twitter on the @twitterapi team, obsessed with rock climbing & running. In a past life I was a member of the Rails Core team.</description>

  <profile_image_url>http://a3.twimg.com/profile_images/53473799/marcel-euro-rails-conf_normal.jpg</profile_image_url>

  <url>http://project.ioni.st</url>

  <protected>false</protected>

  <followers_count>102187</followers_count>

  <profile_background_color>9AE4E8</profile_background_color>

  <profile_text_color>333333</profile_text_color>

  <profile_link_color>0084B4</profile_link_color>

  <profile_sidebar_fill_color>DDFFCC</profile_sidebar_fill_color>

  <profile_sidebar_border_color>BDDCAD</profile_sidebar_border_color>

  <friends_count>356</friends_count>

  <created_at>Mon Apr 02 07:47:28 +0000 2007</created_at>

  <favourites_count>137</favourites_count>

  <utc_offset>-28800</utc_offset>

  <time_zone>Pacific Time (US & Canada)</time_zone>

  <profile_background_image_url>http://a1.twimg.com/profile_background_images/18156348/jessica_tiled.jpg.jpeg</profile_background_image_url>

  <profile_background_tile>true</profile_background_tile>

  <statuses_count>3526</statuses_count>

  <notifications>false</notifications>

  <geo_enabled>true</geo_enabled>

  <verified>false</verified>

  <following>false</following>

  <status>

    <created_at>Tue Nov 03 22:20:43 +0000 2009</created_at>

    <id>5403407683</id>

    <text>@adambair Haven't been for a couple years. I miss how efficient it is for most things but attachments are a pain. I mostly use gmail now.</text>

    <source><a href="http://www.atebits.com/" rel="nofollow">Tweetie</a></source>

    <truncated>false</truncated>

    <in_reply_to_status_id>5401091700</in_reply_to_status_id>

    <in_reply_to_user_id>10647472</in_reply_to_user_id>

    <favorited>false</favorited>

    <in_reply_to_screen_name>adambair</in_reply_to_screen_name>

    <geo/>

  </status>

</user>

<user>

  <id>8285392</id>

  <name>raffi</name>

  <screen_name>raffi</screen_name>

  <location>San Francisco, California</location>

  <description>Tinkering, writing, engineering, and breaking things on the Twitter Platform team.</description>

  <profile_image_url>http://a1.twimg.com/profile_images/364041028/raffi-headshot-casual_normal.png</profile_image_url>

  <url>http://www.mehack.com/</url>

  <protected>false</protected>

  <followers_count>898</followers_count>

  <profile_background_color>d0e4ef</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>158</friends_count>

  <created_at>Sun Aug 19 14:24:06 +0000 2007</created_at>

  <favourites_count>45</favourites_count>

  <utc_offset>-28800</utc_offset>

  <time_zone>Pacific Time (US & Canada)</time_zone>

  <profile_background_image_url>http://s.twimg.com/a/1257288876/images/themes/theme1/bg.png</profile_background_image_url>

  <profile_background_tile>false</profile_background_tile>

  <statuses_count>1382</statuses_count>

  <notifications></notifications>

  <geo_enabled>true</geo_enabled>

  <verified>false</verified>

  <following></following>

  <status>

    <created_at>Wed Nov 04 17:27:52 +0000 2009</created_at>

    <id>5425363300</id>

    <text>RT @rsarver: great twitter viz apps (@mashable post from June) - http://bit.ly/Cq14r. "Just Landed" is my favorite #appwednesday @blprnt ...</text>

    <source>web</source>

    <truncated>true</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>

    <retweeted_status>

      <created_at>Wed Nov 04 17:25:39 +0000 2009</created_at>

      <id>5425312524</id>

      <text>great twitter viz apps (@mashable post from June) - http://bit.ly/Cq14r. "Just Landed" is my favorite #appwednesday @blprnt @twistori</text>

      <source><a href="http://www.atebits.com/" rel="nofollow">Tweetie</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>

      <geo/>

    </retweeted_status>

    <geo/>

  </status>

</user>

<user>

  <id>795649</id>

  <name>Ryan Sarver</name>

  <screen_name>rsarver</screen_name>

  <location>San Francisco, CA, USA</location>

  <description>platform/api at twitter</description>

  <profile_image_url>http://a3.twimg.com/profile_images/53700173/2448434960_65aba38823_t_normal.jpg</profile_image_url>

  <url>http://sarver.org</url>

  <protected>false</protected>

  <followers_count>102741</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>347</friends_count>

  <created_at>Mon Feb 26 18:05:55 +0000 2007</created_at>

  <favourites_count>8</favourites_count>

  <utc_offset>-28800</utc_offset>

  <time_zone>Pacific Time (US & Canada)</time_zone>

  <profile_background_image_url>http://a1.twimg.com/profile_background_images/64392/palefruity_sm.jpg</profile_background_image_url>

  <profile_background_tile>true</profile_background_tile>

  <statuses_count>1166</statuses_count>

  <notifications>false</notifications>

  <geo_enabled>true</geo_enabled>

  <verified>false</verified>

  <following>false</following>

  <status>

    <created_at>Wed Nov 04 18:19:22 +0000 2009</created_at>

    <id>5426526063</id>

    <text>RT @rk: I just did the math in my head and it seems that twitter has had better uptime so far this year than the Bay Bridge.</text>

    <source>web</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>

    <retweeted_status>

      <created_at>Wed Nov 04 18:12:29 +0000 2009</created_at>

      <id>5426380143</id>

      <text>I just did the math in my head and it seems that twitter has had better uptime so far this year than the Bay Bridge.</text>

      <source><a href="http://twitterrific.com" rel="nofollow">Twitterrific</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>

      <geo/>

    </retweeted_status>

    <geo/>

  </status>

</user>

</users>

<next_cursor>0</next_cursor>

<previous_cursor>0</previous_cursor>

</users_list>