TwitterAPI 2.2 documentation

Tiny Examples

«  Paging Results   ::   Contents   ::   TwitterAPI.TwitterAPI  »

Tiny Examples

All the examples assume api is an authenticated instance of TwitterAPI. Typically, this is done as follows:

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

Get your last 50 tweets

r = api.request('statuses/home_timeline', {'count':50})
for item in r.get_iterator():
    if 'text' in item:
        print item['text']

Get your entire timeline

pager = TwitterRestPager(api, 'statuses/home_timeline', {'count':200})
for item in pager.get_iterator(wait=60):
    if 'text' in item:
        print item['text']

Post a tweet

r = api.request('statuses/update', {'status': 'I need pizza!'})
print 'SUCCESS' if r.status_code == 200 else 'FAILURE'

Post a tweet with a picture

# STEP 1 - upload image
file = open('./image_of_pizza.png', 'rb')
data = file.read()
r = api.request('media/upload', None, {'media': data})
print('UPLOAD MEDIA SUCCESS' if r.status_code == 200 else 'UPLOAD MEDIA FAILURE')

# STEP 2 - post tweet with reference to uploaded image
if r.status_code == 200:
        media_id = r.json()['media_id']
        r = api.request('statuses/update', {'status':'I found pizza!', 'media_ids':media_id})
        print('UPDATE STATUS SUCCESS' if r.status_code == 200 else 'UPDATE STATUS FAILURE')

Stream tweets

r = api.request('statuses/filter', {'track':'pizza'})
for item in r.get_iterator():
    if 'text' in item:
        print item['text']

«  Paging Results   ::   Contents   ::   TwitterAPI.TwitterAPI  »