Favorites

GET /api/favorites.json

Returns recent notices favorited by the authenticating or specified user.

Query Parameters:
 
  • user_id (int) – ID of the user for whom to return results for
  • screen_name (string) – handle of the user for whom to return results for
  • count (int) – number of statuses to try and retrieve
  • since_id (int) – returns statuses with an ID greater than (that is, more recent than) the specified ID
  • max_id (int) – returns statuses with an ID less than (that is, older than) or equal to the specified ID

Example response: a list of status objects

POST /api/favorites/create/(int: status_id).json

Favorites a status.

Parameters:
  • status_id (int) – ID of the status to favorite
Request Headers:
 
  • Authorization – username and password or OAuth token to authenticate

Example response: Status object

POST /api/favorites/destroy/(int: status_id).json

Unfavorites a status.

Parameters:
  • status_id (int) – ID of the status to unfavorite
Request Headers:
 
  • Authorization – username and password or OAuth token to authenticate

Example response: Status object