h1. An easy way to access Twitter data with Python.

Twython is a Python API wrapper for the Twitter REST API.

from twython import Twython

# Create a Twython instance
# Note: For OAuth examples, see the included Django application.
twitter = Twython()
twitter.searchTwitter(q="bert")

h1. Does the world really need another Twitter API Wrapper?

Maybe you're happy with the current crop of Twitter libraries for Python, but I'm honestly a little dissapointed. Other projects seem a bit outdated, or they don't cover the full API. Twython is (hopefully) the one Twitter library for Python that 100% covers the API, and is actively maintained.

h1. What does Twython require?

Twython requires the "simplejson":http://code.google.com/p/simplejson/ library for parsing Twitter responses, as well as oauth2 for handling OAuth authentication.

h1. I have a patch, can I contribute back?

Twython is open source, so you can make changes, hack on it, update it, whatever you think works for you. If you make a change that you think might help the community, or you find and fix a bug, hit the project up on Github.

Twython was created, and is maintained, by "Ryan McGrath":http://twitter.com/ryanmcgrath. Twython is released under a BSD style license. Questions, comments? Email "ryan" [at] "venodesigns.net".