GET :user/lists

API version 1
Updated on Wed, 2012-08-22 08:55

This method is deprecated and has been replaced by GET lists. Please update your applications with the new endpoint.

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

Resource URL

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

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 in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.

Example Values: 12893764510938

Example Request

GET http://api.twitter.com/1/twitter/lists.json?cursor=-1

  1. {
  2.   "previous_cursor": 0,
  3.   "lists": [
  4.     {
  5.       "slug": "nfl-playoffs",
  6.       "name": "NFL: Playoffs",
  7.       "uri": "/twitter/nfl-playoffs",
  8.       "subscriber_count": 150,
  9.       "id_str": "32996620",
  10.       "member_count": 225,
  11.       "mode": "public",
  12.       "id": 32996620,
  13.       "full_name": "@twitter/nfl-playoffs",
  14.       "description": "",
  15.       "user": {
  16.         "profile_sidebar_border_color": "EEEEEE",
  17.         "name": "Twitter",
  18.         "profile_background_tile": false,
  19.         "profile_sidebar_fill_color": "F6F6F6",
  20.         "created_at": "Tue Feb 20 14:35:54 +0000 2007",
  21.         "profile_image_url": "http://a2.twimg.com/profile_images/1124040897/at-twitter_normal.png",
  22.         "location": "San Francisco, CA",
  23.         "is_translator": false,
  24.         "profile_link_color": "038543",
  25.         "follow_request_sent": false,
  26.         "id_str": "783214",
  27.         "url": "http://twitter.com",
  28.         "contributors_enabled": true,
  29.         "favourites_count": 2,
  30.         "utc_offset": -28800,
  31.         "id": 783214,
  32.         "listed_count": 53302,
  33.         "profile_use_background_image": true,
  34.         "lang": "ko",
  35.         "protected": false,
  36.         "followers_count": 0,
  37.         "profile_text_color": "333333",
  38.         "verified": true,
  39.         "time_zone": "Pacific Time (US & Canada)",
  40.         "notifications": false,
  41.         "profile_background_color": "ACDED6",
  42.         "description": "Always wondering what's happening. ",
  43.         "geo_enabled": true,
  44.         "statuses_count": 1932,
  45.         "friends_count": 390,
  46.         "profile_background_image_url": "http://a2.twimg.com/a/1295550980/images/themes/theme18/bg.gif",
  47.         "screen_name": "twitter",
  48.         "show_all_inline_media": true,
  49.         "following": true
  50.       },
  51.       "following": false
  52.     },
  53.     {
  54.       "slug": "more-twitter-accounts",
  55.       "name": "More @Twitter Accounts",
  56.       "uri": "/twitter/more-twitter-accounts",
  57.       "subscriber_count": 2063,
  58.       "id_str": "5157981",
  59.       "member_count": 21,
  60.       "mode": "public",
  61.       "id": 5157981,
  62.       "full_name": "@twitter/more-twitter-accounts",
  63.       "description": "",
  64.       "user": {
  65.         "profile_sidebar_border_color": "EEEEEE",
  66.         "name": "Twitter",
  67.         "profile_background_tile": false,
  68.         "profile_sidebar_fill_color": "F6F6F6",
  69.         "created_at": "Tue Feb 20 14:35:54 +0000 2007",
  70.         "profile_image_url": "http://a2.twimg.com/profile_images/1124040897/at-twitter_normal.png",
  71.         "location": "San Francisco, CA",
  72.         "is_translator": false,
  73.         "profile_link_color": "038543",
  74.         "follow_request_sent": false,
  75.         "id_str": "783214",
  76.         "url": "http://twitter.com",
  77.         "contributors_enabled": true,
  78.         "favourites_count": 2,
  79.         "utc_offset": -28800,
  80.         "id": 783214,
  81.         "listed_count": 53302,
  82.         "profile_use_background_image": true,
  83.         "lang": "ko",
  84.         "protected": false,
  85.         "followers_count": 0,
  86.         "profile_text_color": "333333",
  87.         "verified": true,
  88.         "time_zone": "Pacific Time (US & Canada)",
  89.         "notifications": false,
  90.         "profile_background_color": "ACDED6",
  91.         "description": "Always wondering what's happening. ",
  92.         "geo_enabled": true,
  93.         "statuses_count": 1932,
  94.         "friends_count": 390,
  95.         "profile_background_image_url": "http://a2.twimg.com/a/1295550980/images/themes/theme18/bg.gif",
  96.         "screen_name": "twitter",
  97.         "show_all_inline_media": true,
  98.         "following": true
  99.       },
  100.       "following": false
  101.     },
  102.     {
  103.       "slug": "team",
  104.       "name": "Team",
  105.       "uri": "/twitter/team",
  106.       "subscriber_count": 76387,
  107.       "id_str": "574",
  108.       "member_count": 353,
  109.       "mode": "public",
  110.       "id": 574,
  111.       "full_name": "@twitter/team",
  112.       "description": "",
  113.       "user": {
  114.         "profile_sidebar_border_color": "EEEEEE",
  115.         "name": "Twitter",
  116.         "profile_background_tile": false,
  117.         "profile_sidebar_fill_color": "F6F6F6",
  118.         "created_at": "Tue Feb 20 14:35:54 +0000 2007",
  119.         "profile_image_url": "http://a2.twimg.com/profile_images/1124040897/at-twitter_normal.png",
  120.         "location": "San Francisco, CA",
  121.         "follow_request_sent": false,
  122.         "profile_link_color": "038543",
  123.         "is_translator": false,
  124.         "id_str": "783214",
  125.         "url": "http://twitter.com",
  126.         "contributors_enabled": true,
  127.         "favourites_count": 2,
  128.         "utc_offset": -28800,
  129.         "id": 783214,
  130.         "listed_count": 53309,
  131.         "profile_use_background_image": true,
  132.         "lang": "ko",
  133.         "protected": false,
  134.         "followers_count": 4199053,
  135.         "profile_text_color": "333333",
  136.         "time_zone": "Pacific Time (US & Canada)",
  137.         "notifications": false,
  138.         "geo_enabled": true,
  139.         "profile_background_color": "ACDED6",
  140.         "verified": true,
  141.         "description": "Always wondering what's happening. ",
  142.         "friends_count": 390,
  143.         "statuses_count": 1932,
  144.         "profile_background_image_url": "http://a2.twimg.com/a/1295550980/images/themes/theme18/bg.gif",
  145.         "screen_name": "twitter",
  146.         "show_all_inline_media": true,
  147.         "following": false
  148.       },
  149.       "following": true
  150.     }
  151.   ],
  152.   "previous_cursor_str": "0",
  153.   "next_cursor": 0,
  154.   "next_cursor_str": "0"
  155. }