• 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 statuses

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

Twitter REST API Method: GET /:user/lists/:list_id/statuses

Show tweet timeline for members of the specified list.

 

URL:

http://api.twitter.com/1/user/lists/list_id/statuses.format

 

Formats: 

xml, json, atom

 

HTTP Method(s):

GET

 

Requires Authentication (about authentication):

false

 

API rate limited (about rate limiting):

true

 

Parameters:

  • since_id Optional.  Returns only statuses with an ID greater than (that is, more recent than) the specified ID. 
    • Example: http://api.twitter.com/1/twitterapi/lists/team/statuses.xml?since_id=12345
  • max_id. Optional.  Returns only statuses with an ID less than (that is, older than) or equal to the specified ID.
    • Example: http://api.twitter.com/1/twitterapi/lists/team/statuses.xml?max_id=54321
  • per_page.  Optional.  Specifies the number of statuses to retrieve. May not be greater than 200. 
    • Example: http://api.twitter.com/1/twitterapi/lists/team/statuses.xml?per_page=5 
  • page. Optional. Specifies the page of results to retrieve. Note: there are pagination limits.

    • Example: http://api.twitter.com/1/twitterapi/lists/team/statuses.xml?page=3 

 

Usage examples:

cURL (about cURL):

curl -u user:password 'http://api.twitter.com/1/twitterapi/lists/team/statuses.xml?per_page=3'

 

Response (about return values): 

XML example:

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

<statuses type="array">

<status>

  <created_at>Wed Nov 04 01:32:00 +0000 2009</created_at>

  <id>5408168060</id>

  <text>¡odelay!</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>

  <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>357</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>139</statuses_count>

    <notifications>false</notifications>

    <geo_enabled>false</geo_enabled>

    <verified>false</verified>

    <following>false</following>

  </user>

  <geo/>

</status>

<status>

  <created_at>Wed Nov 04 01:03:39 +0000 2009</created_at>

  <id>5407456349</id>

  <text>thanks to @loic and team for coming by the office today for demos. they have some hot stuff coming! it's inspiring to see all the great work</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>

  <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>100314</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>1159</statuses_count>

    <notifications>false</notifications>

    <geo_enabled>true</geo_enabled>

    <verified>false</verified>

    <following>true</following>

  </user>

  <geo/>

</status>

<status>

  <created_at>Tue Nov 03 23:29:36 +0000 2009</created_at>

  <id>5405100877</id>

  <text>RT @twitter_es: ¡Por fin! Twitter en español. ¡Hola a todos!</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>Tue Nov 03 23:17:03 +0000 2009</created_at>

    <id>5404790442</id>

    <text>¡Por fin! Twitter en español. ¡Hola a todos!</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>

    <user>

      <id>85426644</id>

      <name>Twitter Español</name>

      <screen_name>twitter_es</screen_name>

      <location>San Francisco, CA</location>

      <description>¡Bienvenidos a la cuenta oficial de Twitter en español!</description>

      <profile_image_url>http://a3.twimg.com/profile_images/504883319/twitter_bird_profile_normal.png</profile_image_url>

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

      <protected>false</protected>

      <followers_count>570</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>1</friends_count>

      <created_at>Mon Oct 26 21:54:02 +0000 2009</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/1257284639/images/themes/theme1/bg.png</profile_background_image_url>

      <profile_background_tile>false</profile_background_tile>

      <statuses_count>4</statuses_count>

      <notifications>false</notifications>

      <geo_enabled>false</geo_enabled>

      <verified>false</verified>

      <following>false</following>

    </user>

    <geo/>

  </retweeted_status>

  <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>456</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>156</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/1257284639/images/themes/theme1/bg.png</profile_background_image_url>

    <profile_background_tile>false</profile_background_tile>

    <statuses_count>1110</statuses_count>

    <notifications>false</notifications>

    <geo_enabled>false</geo_enabled>

    <verified>false</verified>

    <following>true</following>

  </user>

  <geo/>

</status>

</statuses>

 

Comments (0)

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