This section will cover how to use Twython and interact with some basic Twitter API calls
Before you make any API calls, make sure you authenticated the user (or app)!
Note
All sections on this page will assume you’re using a Twython instance
Create a Twython instance with your application keys and the users OAuth tokens
from twython import Twython
twitter = Twython(APP_KEY, APP_SECRET,
OAUTH_TOKEN, OAUTH_TOKEN_SECRET)
Documentation: https://developer.twitter.com/en/docs/accounts-and-users/manage-account-settings/api-reference/get-account-verify_credentials
twitter.verify_credentials()
Documentation: https://developer.twitter.com/en/docs/tweets/timelines/api-reference/get-statuses-home_timeline
twitter.get_home_timeline()
This method makes use of dynamic arguments, read more about them
Documentation: https://developer.twitter.com/en/docs/tweets/post-and-engage/api-reference/post-statuses-update
twitter.update_status(status='See how easy using Twython is!')
Create a Twython instance with your application key and access token
from twython import Twython
twitter = Twython(APP_KEY, access_token=ACCESS_TOKEN)
Note
Searching can be done whether you’re authenticated via OAuth 1 or OAuth 2
Documentation: https://developer.twitter.com/en/docs/tweets/search/api-reference/get-search-tweets
twitter.search(q='python')
Important
To help explain dynamic function arguments a little more, you can see that the previous call used the keyword argument q
, that is because Twitter specifies in their search documentation that the search call accepts the parameter “q”. You can pass mutiple keyword arguments. The search documentation also specifies that the call accepts the parameter “result_type”
twitter.search(q='python', result_type='popular')
So, now, you’re pretty well versed on making authenticated calls to Twitter using Twython. Check out the advanced usage section, for some functions that may be a little more complicated.