marcosvbras/twitton

A simple Python library to make Twitter Search API easily to use

Twitton

Twitton is a Python library that provides easy Twitter Search API use.

With this library you can:

• Create powerful searches
• Get all available tweet information
• Use your own Twitter search URL's

Installation

Run the command:

pip install twitton

Basic use

Import the TweetSearch class and create an object. Pass consumer_key, consumer_key_secret, access_token and access_token_secret arguments to constructor.

from twitton import TweetSearch

tweet_search = TweetSearch(
    consumer_key,
    consumer_secret,
    access_token,
    access_token_secret
  )

NOTE: These arguments are required. Twitter API calls always requires authentication.

Then, specify some search arguments

tweet_search.set_keyword_list(['Star Wars', 'movie'])
tweet_search.set_result_type("recent")
tweet_search.set_language("en")
tweet_search.set_max_tweet_response(100)
result = tweet_search.search_tweets()

This settings will look up for tweets that contains "Star Wars" and "movie", published recently, written in english and will return 100 results.

You can iterate the object to get all available tweet dict:

for tweet in result:
  print(tweet)

Do you need more results? Search for the next tweets in sequence

result = tweet_search.search_older_tweets()

... or search for the new ones published after your last search

result = tweet_search.search_newer_tweets()