<< Back to TLists API Documentation

categories/users

Get the most frequently listed users under a given category.

URL: 

http://api.tlists.com/api/v2/categories/<category-path>/users.<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.
• force_error: Optional. 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:

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

Example request:

http://api.tlists.com/api/v2/categories/all/politics/users.json