Fork me on GitHub Basic Usage — Twython 3.8.0 documentation

Basic Usage

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)!


All sections on this page will assume you’re using a Twython instance

Authenticated Calls

OAuth 1

Create a Twython instance with your application keys and the users OAuth tokens

from twython import Twython
twitter = Twython(APP_KEY, APP_SECRET,

Authenticated Users Home Timeline



Updating Status

This method makes use of dynamic arguments, read more about them


twitter.update_status(status='See how easy using Twython is!')

OAuth 2

Create a Twython instance with your application key and access token

from twython import Twython
twitter = Twython(APP_KEY, access_token=ACCESS_TOKEN)



Searching can be done whether you’re authenticated via OAuth 1 or OAuth 2



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”'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.