Statuses¶

statuses.update(server_url, *args, **kwargs)¶

Updates the authenticating user’s current status.

Accepts the same parameters as requests.post() except url.

Implements https://twitter-api.readthedocs.io/en/latest/statuses.html#post–api-statuses-update.json

Parameters:	server_url (str) – URL of the server
Return type:	dict
Returns:	Status dict

statuses.show(server_url, status_id, *args, **kwargs)¶

Returns a specified status.

Accepts the same parameters as requests.get() except url.

Implements https://twitter-api.readthedocs.io/en/latest/statuses.html#get–api-statuses-show-(int-status_id).json

Parameters:	server_url (str) – URL of the server
Return type:	dict
Returns:	Status dict

statuses.destroy(server_url, status_id, *args, **kwargs)¶

Deletes the status specified by the required ID parameter. The authenticating user must be the author of the specified status. Returns the destroyed status if successful.

Accepts the same parameters as requests.post() except url.

Implements https://twitter-api.readthedocs.io/en/latest/statuses.html#post–api-statuses-destroy-(int-status_id).json

Parameters:	server_url (str) – URL of the server status_id (int) – ID of the status to delete
Return type:	dict
Returns:	Status dict

statuses.repeat(server_url, status_id, *args, **kwargs)¶

Repeats a status. Returns the original status with repeat details embedded.

Accepts the same parameters as requests.post() except url.

Implements https://twitter-api.readthedocs.io/en/latest/statuses.html#post–api-statuses-retweet-(int-status_id).json

Parameters:	server_url (str) – URL of the server status_id (int) – ID of the status to repeat
Return type:	dict
Returns:	Status dict

statuses.conversation(server_url, conversation_id, *args, **kwargs)¶

Returns statuses that have been posted in the conversation

Accepts the same parameters as requests.get() except url.

Implements https://twitter-api.readthedocs.io/en/latest/statuses.html#get–api-statuses-conversation-(int-conversation_id).json

Parameters:	server_url (str) – URL of the server conversation_id (int) – ID of the conversation to show
Return type:	list
Returns:	a list of status dicts

statuses.favorite(server_url, status_id, *args, **kwargs)¶

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

Accepts the same parameters as requests.post() except url.

Implements https://twitter-api.readthedocs.io/en/latest/favorites.html

Parameters:	server_url (str) – URL of the server status_id (int) – ID of the status to favorite
Return type:	dict
Returns:	Status dict

statuses.unfavorite(server_url, status_id, *args, **kwargs)¶

Unfavorites the status specified in the ID parameter as the authenticating user. Returns the unliked status when successful.

Accepts the same parameters as requests.post() except url.

Implements https://twitter-api.readthedocs.io/en/latest/favorites.html#post–api-favorites-destroy-(int-status_id).json

Parameters:	server_url (str) – URL of the server status_id (int) – ID of the status to unfavorite
Return type:	dict
Returns:	Status dict

statuses.favorites(server_url, *args, **kwargs)¶

Returns recent notices favorited by the authenticating or specified user.

Accepts the same parameters as requests.get() except url.

Implements https://twitter-api.readthedocs.io/en/latest/favorites.html#get–api-favorites.json

Parameters:	server_url (str) – URL of the server
Return type:	list
Returns:	a list of status dicts