Favorites

favorites.create(server_url, status_id, *, username='', password='', oauth={})

Favorites the status specified in the ID parameter as the authenticating user. Returns the liked status when successful.

Parameters:
  • server_url (str) – URL of the server
  • status_id (int) – ID of the status to delete
  • username (str) – (optional) name of the authenticating user
  • password (str) – (optional) password of the authenticating user
  • oauth (dict) – (optional) OAuth dict
Return type:

dict
Returns:

Status dict
favorites.destroy(server_url, status_id, *, username='', password='', oauth={})
Unfavorites the status specified in the ID parameter as the authenticating user. Returns the unliked status when successful.
Parameters:
  • server_url (str) – URL of the server
  • status_id (int) – ID of the status to delete
  • username (str) – (optional) name of the authenticating user
  • password (str) – (optional) password of the authenticating user
  • oauth (dict) – (optional) OAuth dict
Return type:

dict
Returns:

Status dict
favorites.favorites(server_url, *, since_id=None, max_id=None, count=20, username='', password='', oauth={})

Returns recent notices favorited by the authenticating or specified user.

Parameters:
  • server_url (str) – URL of the server
  • since_id (int) – (optional) returns statuses with an ID greater than (that is, more recent than) the specified ID
  • max_id (int) – (optional) returns statuses with an ID less than (that is, older than) or equal to the specified ID
  • count (int) – (optional) number of statuses to try and retrieve
  • username (str) – (optional) name of the authenticating user
  • password (str) – (optional) password of the authenticating user
  • oauth (dict) – (optional) OAuth dict
Return type:

list
Returns:

a list of status dicts