Twitter REST API Method: GET /:user/lists

List the lists of the specified user. Private lists will be included if the authenticated users is the same as the user who'se lists are being returned.

URL:

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

 

Formats: 

xml, json

 

HTTP Method(s):

GET

 

Requires Authentication (about authentication):

true

 

API rate limited (about rate limiting):

true

 

Parameters:

• 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/twitterapidocs/lists.xml?cursor=-1
  • Example: http://api.twitter.com/1/twitterapidocs/lists.xml?cursor=-1300794057949944903

 

 

Usage examples:

cURL (about cURL):

curl -u user:password  http://api.twitter.com/1/twitterapidocs/lists.xml

 

Response (about return values): 

XML example:

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

<lists_list>

<lists type="array">

<list>

  <id>2029636</id>

  <name>firemen</name>

  <full_name>@twitterapidocs/firemen</full_name>

  <slug>firemen</slug>

  <description></description>

  <subscriber_count>0</subscriber_count>

  <member_count>0</member_count>

  <uri>/twitterapidocs/firemen</uri>

  <mode>public</mode>

  <user>

    <id>86621024</id>

    <name>API Documentation</name>

    <screen_name>twitterapidocs</screen_name>

    <location></location>

    <description>The @twitterapi team uses me to generate API documentation.</description>

    <profile_image_url>http://s.twimg.com/a/1257288876/images/default_profile_0_normal.png</profile_image_url>

    <url></url>

    <protected>false</protected>

    <followers_count>0</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>0</friends_count>

    <created_at>Sat Oct 31 23:21:40 +0000 2009</created_at>

    <favourites_count>0</favourites_count>

    <utc_offset></utc_offset>

    <time_zone></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>0</statuses_count>

    <notifications>false</notifications>

    <geo_enabled>false</geo_enabled>

    <verified>false</verified>

    <following>false</following>

  </user>

</list>

<list>

  <id>2025372</id>

  <name>surgeons</name>

  <full_name>@twitterapidocs/surgeons</full_name>

  <slug>surgeons</slug>

  <description></description>

  <subscriber_count>0</subscriber_count>

  <member_count>0</member_count>

  <uri>/twitterapidocs/surgeons</uri>

  <mode>private</mode>

  <user>

    <id>86621024</id>

    <name>API Documentation</name>

    <screen_name>twitterapidocs</screen_name>

    <location></location>

    <description>The @twitterapi team uses me to generate API documentation.</description>

    <profile_image_url>http://s.twimg.com/a/1257288876/images/default_profile_0_normal.png</profile_image_url>

    <url></url>

    <protected>false</protected>

    <followers_count>0</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>0</friends_count>

    <created_at>Sat Oct 31 23:21:40 +0000 2009</created_at>

    <favourites_count>0</favourites_count>

    <utc_offset></utc_offset>

    <time_zone></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>0</statuses_count>

    <notifications>false</notifications>

    <geo_enabled>false</geo_enabled>

    <verified>false</verified>

    <following>false</following>

  </user>

</list>

</lists>

<next_cursor>0</next_cursor>

<previous_cursor>0</previous_cursor>

</lists_list>