ryanmcgrath

twython: Access Twitter's API from Python

Twython is a pure-Python wrapper for Twitter's API, covering standard endpoints and the Streaming API. It supports Python 3, but its latest recorded commit is old and the project is currently inactive.

InactivePythonMITLibraryAPITwitter API
Stars
1.9k
Forks
389
Stars, last 30 days
-1
Last commit
4.3 years ago
Contributors
81

Our take

Inactiveno commits in over a year

Health score

32/100

How it is scored
Activity
19
Community
69
Issues
21
Pull requests
20

-1 stars in the last 30 days

Twython is a focused Python wrapper with broad contributor history, but its inactive status and lack of recent maintenance make current Twitter API compatibility an adoption risk.

Good fit if

  • You need a Python 3 library for Twitter API calls or streaming, and its supported endpoints meet your needs.
  • You are maintaining an existing Twython integration or can verify the required API behavior yourself.
  • You value its MIT license and can work with a project that has many contributors and no recent commits.

Look elsewhere if

  • Your application depends on recent upstream fixes or releases, since the project has had no commits in over a year and no releases in the past year.
  • You need active issue or pull-request handling, with no issues closed or pull requests merged in the last 90 days.
  • You require a library with verified compatibility against the current Twitter API.
All health signals
Last commit2022-07-30 (4.3 years ago)
Commits, last 90 days0
Releases, last 12 months0 (latest v3.9.1, 2021-07-16)
Contributors81 (top contributor: 55% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age17 years

Checked on 2026-11-02 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

1,856

Forks

388

Change since Nov 17, 2026: 0 stars·0 forks

Overview

Twython is a pure-Python library for accessing Twitter's API, including both standard API calls and the Streaming API. It gives Python applications a single wrapper for retrieving Twitter data and performing supported account actions, rather than requiring developers to assemble API requests themselves.

It is aimed at Python developers building applications that work with Twitter data, such as timelines, user information, lists, direct messages, or image uploads. The repository supports Python 3; its recorded health status is inactive, so teams should weigh that against their need for ongoing compatibility and maintenance.

Key Features

  • Calls Twitter API endpoints for user information, lists, timelines, and direct messages.
  • Supports Twitter's Streaming API.
  • Handles OAuth 1 user authentication and OAuth 2 application-only, read-only authentication.
  • Supports uploading images to update a status, avatar, background image, or banner.
  • Maps keyword arguments to API endpoint parameters, allowing flexible endpoint queries.
  • Supports Python 3.

Use Cases

  • A Python web application lets users authenticate with Twitter and interact with their timelines.
  • A data collection script retrieves Twitter API data or listens to the Streaming API.
  • An application publishes status updates or changes profile images through Twitter.
  • A read-only tool accesses Twitter data using application-only OAuth 2 authentication.

What you need

Detected in the repository

  • Python (from setup.py)
  • A test suite

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install from PyPI:

pip install twython

See the README and Twython documentation for authentication and usage details.

Considerations

The health data marks the repository inactive: there have been no commits in over a year, no releases in the past year, and no recorded issue closures or merged pull requests in the last 90 days. Although 81 contributors have participated and contributions are not concentrated in one person, that history does not establish current maintenance. The project requires Python; no Docker or Compose setup is listed. It is MIT-licensed, a permissive license, but adopters should still review its terms and confirm that the library's API behavior fits their application.

Found this useful?

Share it with someone who would like twython.

Comparisons