Twython

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

Features

• 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!

Usage

• Installation
  • Pip or Easy Install
  • Source Code

• Starting Out
  • Beginning
  • Authentication
    • OAuth 1 (User Authentication)
      • Obtain Authorization URL
      • Handling the Callback
    • OAuth 2 (Application Authentication)
      • Obtain an OAuth 2 Access Token
      • Use the Access Token
  • The Twython API Table
  • Dynamic Function Arguments
  • What Twython Returns

• Basic Usage
  • Authenticated Calls
    • OAuth 1
      • User Information
      • Authenticated Users Home Timeline
      • Updating Status
    • OAuth 2
  • Searching

• Advanced Usage
  • Updating Status with Image
  • Updating Status with Video
  • Posting a Status with an Editing Image
  • Search Generator
  • Manipulate the Request (headers, proxies, etc.)
  • Access Headers of Previous Call

• Streaming API
  • Setting Up Your Streamer
  • Filtering Public Statuses

• Special Functions
  • Cursor
  • HTML for Tweet

Twython API Documentation

• Developer Interface
  • Core Interface
  • Streaming Interface
  • Exceptions