log inhelp

  • If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • You already know Dokkio is an AI-powered assistant to organize & manage your digital files & messages. Very soon, Dokkio will support Outlook as well as One Drive. Check it out today!

View
 

Twitter REST API Method: GET list subscribers

Page history last edited by Marcel Molina 14 years, 5 months ago

<< Back to Twitter API Documentation

 

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

Returns the subscribers of the specified list.

 

URL:

http://api.twitter.com/1/user/list_id/subscribers.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/subscribers.xml?cursor=-1
    • Example: http://api.twitter.com/1/twitterapi/team/subscribers.xml?cursor=-1300794057949944903

 

Usage examples:

cURL (about cURL):

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

 

Response (about return values): 

XML example:

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

<users_list>

<users type="array">

<user>

  <id>8725692</id>

  <name>knoedeldealer</name>

  <screen_name>knoedeldealer</screen_name>

  <location>Cologne, Germany</location>

  <description>schönwettertwitterer</description>

  <profile_image_url>http://a3.twimg.com/profile_images/56099829/simpsons_me_normal.gif</profile_image_url>

  <url></url>

  <protected>false</protected>

  <followers_count>215</followers_count>

  <profile_background_color>000000</profile_background_color>

  <profile_text_color>333333</profile_text_color>

  <profile_link_color>050505</profile_link_color>

  <profile_sidebar_fill_color>616266</profile_sidebar_fill_color>

  <profile_sidebar_border_color>eeeeee</profile_sidebar_border_color>

  <friends_count>198</friends_count>

  <created_at>Fri Sep 07 14:54:15 +0000 2007</created_at>

  <favourites_count>235</favourites_count>

  <utc_offset>3600</utc_offset>

  <time_zone>Berlin</time_zone>

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

  <profile_background_tile>true</profile_background_tile>

  <statuses_count>3690</statuses_count>

  <notifications>false</notifications>

  <geo_enabled>false</geo_enabled>

  <verified>false</verified>

  <following>false</following>

  <status>

    <created_at>Wed Nov 04 22:50:05 +0000 2009</created_at>

    <id>5432888339</id>

    <text>@Jule_Hoffmann na danke, nun hab ich auch wieder nen Ohrwurm ^^</text>

    <source><a href="http://www.brizzly.com" rel="nofollow">Brizzly</a></source>

    <truncated>false</truncated>

    <in_reply_to_status_id>5431558457</in_reply_to_status_id>

    <in_reply_to_user_id>36762307</in_reply_to_user_id>

    <favorited>false</favorited>

    <in_reply_to_screen_name>Jule_Hoffmann</in_reply_to_screen_name>

    <geo/>

  </status>

</user>

<user>

  <id>15627893</id>

  <name>nambutest</name>

  <screen_name>nambutest</screen_name>

  <location>Everywhere</location>

  <description>Test account for The Nambu Network.</description>

  <profile_image_url>http://a3.twimg.com/profile_images/501658157/nambuicon-512-border_normal.png</profile_image_url>

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

  <protected>true</protected>

  <followers_count>1</followers_count>

  <profile_background_color>000</profile_background_color>

  <profile_text_color>333333</profile_text_color>

  <profile_link_color>1D7D9F</profile_link_color>

  <profile_sidebar_fill_color>EAEAEA</profile_sidebar_fill_color>

  <profile_sidebar_border_color>CCCCCC</profile_sidebar_border_color>

  <friends_count>76</friends_count>

  <created_at>Mon Jul 28 04:38:53 +0000 2008</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://a1.twimg.com/profile_background_images/3206736/n-twtbg.jpg</profile_background_image_url>

  <profile_background_tile>false</profile_background_tile>

  <statuses_count>39</statuses_count>

  <notifications>false</notifications>

  <geo_enabled>false</geo_enabled>

  <verified>false</verified>

  <following>false</following>

</user>

<user>

  <id>10892442</id>

  <name>Brent McConnell</name>

  <screen_name>emcconne</screen_name>

  <location>MA, US</location>

  <description>Community Manager for iFolder and Kablink.  Wantabe muscian and havetabe home repair guy :(</description>

  <profile_image_url>http://a3.twimg.com/profile_images/51999411/headshot_small_normal.jpg</profile_image_url>

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

  <protected>false</protected>

  <followers_count>257</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>425</friends_count>

  <created_at>Thu Dec 06 03:12:05 +0000 2007</created_at>

  <favourites_count>0</favourites_count>

  <utc_offset>-21600</utc_offset>

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

  <profile_background_image_url>http://a3.twimg.com/profile_background_images/39437539/mindby_background.gif</profile_background_image_url>

  <profile_background_tile>false</profile_background_tile>

  <statuses_count>382</statuses_count>

  <notifications>false</notifications>

  <geo_enabled>false</geo_enabled>

  <verified>false</verified>

  <following>false</following>

  <status>

    <created_at>Wed Nov 04 22:08:24 +0000 2009</created_at>

    <id>5431858092</id>

    <text>RT @juliov27612: RT @billtrippe: RT @piers_hollott: RT @ramblingman: Dynamic Publishing Market to Grow @ 20%+  - Frost http://bit.ly/3T6Z9n</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>13348</id>

  <name>Robert Scoble</name>

  <screen_name>Scobleizer</screen_name>

  <location>Half Moon Bay, California, USA</location>

  <description>Geek and technology enthusiasm from a blogger who grew up in Silicon Valley.</description>

  <profile_image_url>http://a1.twimg.com/profile_images/456562836/scoblebuilding43crop-fanatiguy_normal.jpg</profile_image_url>

  <url>http://friendfeed.com/scobleizer</url>

  <protected>false</protected>

  <followers_count>102141</followers_count>

  <profile_background_color>C6E2EE</profile_background_color>

  <profile_text_color>663B12</profile_text_color>

  <profile_link_color>1F98C7</profile_link_color>

  <profile_sidebar_fill_color>DAECF4</profile_sidebar_fill_color>

  <profile_sidebar_border_color>C6E2EE</profile_sidebar_border_color>

  <friends_count>13884</friends_count>

  <created_at>Mon Nov 20 23:43:44 +0000 2006</created_at>

  <favourites_count>8073</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/31266726/scoblebuilding43small.jpg</profile_background_image_url>

  <profile_background_tile>true</profile_background_tile>

  <statuses_count>25983</statuses_count>

  <notifications>false</notifications>

  <geo_enabled>false</geo_enabled>

  <verified>true</verified>

  <following>false</following>

  <status>

    <created_at>Wed Nov 04 23:12:14 +0000 2009</created_at>

    <id>5433448552</id>

    <text>Yeah, @RealTweeter I have your iPhone power cable. In exchange I'm now following Real Networks at @RealPlayer/realnetworks</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>

    <geo/>

  </status>

</user>

</users>

<next_cursor>0</next_cursor>

<previous_cursor>0</previous_cursor>

</users_list>

Comments (0)

You don't have permission to comment on this page.

Printable version