skip to navigation
skip to content

Not Logged In


Minimal wrapper for Twitter's REST and Streaming APIs

Package Documentation

Latest Version: 2.3.3

This python package supports Twitter's REST and Streaming APIs (version 1.1) with OAuth 1.0 or OAuth 2.0. It works with the latest python versions in both 2.x and 3.x branches.

Code Usage
*See TwitterAPI/ for a working code example.*

First, authenticate with your application credentials:

from TwitterAPI import TwitterAPI
api = TwitterAPI(consumer_key, consumer_secret, access_token_key, access_token_secret)

Tweet something:

r = api.request('statuses/update', {'status':'This is a tweet!'})
print r.status_code

Get some tweets:

r = api.request('search/tweets', {'q':'zzz'})
for item in r.get_iterator():
print item

Stream tweets from New York City:

r = api.request('statuses/filter', {'locations':'-74,40,-73,41'})
for item in r.get_iterator():
print item

Notice that request() accepts both REST and Streaming API methods, and it takes two arguments: 1) the Twitter method, 2) a dictionary of method parameters. In the above examples we use the get\_iterator() helper to get each tweet object. This iterator knows how to iterate both REST and Streaming API results, in addition to error objects. Alternatively, you have access to the response object which is returned by request(). From the response object you can get the raw response (.text) and the http status code (.status\_code). See the documentation for the Requests library for more info.

Command-line Usage
For help:

> python -u -m TwitterAPI.cli -h

You will need to supply your Twitter application OAuth credentials. The easiest option is to enter them in TwitterAPI/credentials.txt. It is the default place where will look for them. You also can supply an alternative credentials file as a command-line argument.

Call any REST API endpoint:

> python -u -m TwitterAPI.cli -endpoint statuses/update -parameters status='my tweet'

Another example (here using abbreviated option names) that parses selected output fields:

> python -u -m TwitterAPI.cli -e search/tweets -p q=zzz count=10 -field screen_name text

Calling any Streaming API endpoint works too:

> python -u -m TwitterAPI.cli -e statuses/filter -p track=zzz -f screen_name text

After the -field option you must supply one or more key names from the raw JSON response object. This will print values only for these keys. When the -field option is omitted prints the entire JSON response object.

> pip install TwitterAPI

* Jonas Geduldig
* Andrea Biancini  
File Type Py Version Uploaded on Size
TwitterAPI- (md5) Source 2014-01-03 8KB
  • Downloads (All Versions):
  • 139 downloads in the last day
  • 1039 downloads in the last week
  • 4655 downloads in the last month