<< Back to TLists API Documentation

categories/lists

Browse lists under a given category. This works for any level 2 category (e.g., "/all/sports/baseball").

URL: 

http://api.tlists.com/api/v2/categories/<category-path>/lists.<format>   

Formats:

json, xml

HTTP Method(s): 

GET  

Parameters: 

• rpp: Optional. The number of lists to return for request (default is 10).
• page: Optional. The page number, starting at 1.
• sort: Optional. Either "top" (to sort by decreasing number of subscribers) or "new" (to sort by most recently created). The default is "top"
• curator: Optional. NEW! A twitter screen_name. Will only return lists curated by that screen_name.

   

• force_error: Optional. NEW! If this parameter is included and set to a value of 200, the server will return no data. If the value is set to 400, 404, 500, 502 or 503, the server will return the respective HTTP response code. This parameter should only be used to test clients against expected or unexpected downtime.  

Returns the following fields:

• lists: A set of list objects
• total_count: The total number of lists matching
• page_count: The total number of pages
• page: The current page number
• rpp: The number of lists per page

Example requests:

http://api.tlists.com/api/v2/categories/all/lists.json