Fork me on GitHub Twython — Twython 3.3.0 documentation
Open Table Of Contents


Actively maintained, pure Python wrapper for the Twitter API. Supports both normal and streaming Twitter APIs


  • Query data for:
    • User information
    • Twitter lists
    • Timelines
    • Direct Messages
    • and anything found in the Twitter API docs.
  • Image Uploading:
    • Update user status with an image
    • Change user avatar
    • Change user background image
    • Change user banner image
  • OAuth 2 Application Only (read-only) Support

  • Support for Twitter’s Streaming API

  • Seamless Python 3 support!