twython
Actively maintained, pure Python wrapper for the Twitter API. Supports both normal and streaming Twitter APIs
Decision gist · record as of 2026-08-14
No—unless you are maintaining legacy code already using Twython. The package is abandoned (last release 2021-07-16, no commits since), so it will not receive security updates or adapt to Twitter API changes. For new projects, use an actively maintained Twitter API client instead. If you must use it, audit the codebase for compatibility with current Twitter API versions and OAuth flows before deploying.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.5 or later.
- You must obtain Twitter API credentials (Consumer Key, Consumer Secret, and OAuth tokens) from https://apps.twitter.com before authenticating.
- Low install friction with only two runtime dependencies (requests and requests-oauthlib).
License · maintenance · safety
MIT (permissive) — Licensed under MIT (permissive), so you can use, modify, and distribute Twython freely in commercial and private projects without significant legal restriction.
last release 2021-07-16 (1855 days) · last repo commit 2022-07-30 · 1,861 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 122,345 downloads/mo, #11,956 on PyPI
Alternatives
Verify before relying
pip install twython
from twython import Twython
twitter = Twython(APP_KEY, APP_SECRET, OAUTH_TOKEN, OAUTH_TOKEN_SECRET)
twitter.update_status(status='See how easy using Twython is!')- Whether Twitter API endpoints have changed since the last release in 2021 and whether Twython still works with current Twitter API versions
- Current state of OAuth token handling and whether Twitter's authentication flow changes are reflected in the codebase
What it is and what it does
Twython is a pure Python wrapper around Twitter's REST and streaming APIs, designed to handle OAuth authentication (both OAuth 1 user auth and OAuth 2 app-only) and provide a simple interface to Twitter endpoints. It abstracts away the HTTP details and OAuth handshake, letting you call methods like `get_home_timeline()` or `update_status()` directly. The library maps keyword arguments to Twitter API parameters dynamically, so you can pass any query option the API supports without waiting for library updates.
The package depends on requests for HTTP calls and requests-oauthlib for OAuth token management. It supports image uploads (avatars, banners, status media) and includes a streaming API client for real-time tweet consumption. However, the project has been abandoned since mid-2021, with no active maintenance or updates to handle Twitter API changes or security issues.
Use it for
- Build a web app where users sign in with Twitter and post to their timeline using OAuth 1 user authentication
- Create a bot or monitoring tool that reads tweets from a timeline or search endpoint using app-only OAuth 2
- Stream live tweets in real time to process or analyze them as they arrive
- Automate posting images or media to a Twitter account programmatically
- Query user profiles, follower lists, or tweet metadata for data collection or analytics
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No—unless you are maintaining legacy code already using Twython.
The package is abandoned (last release 2021-07-16, no commits since), so it will not receive security updates or adapt to Twitter API changes. For new projects, use an actively maintained Twitter API client instead. If you must use it, audit the codebase for compatibility with current Twitter API versions and OAuth flows before deploying.
Install
twython on PyPI
Before you install
Low install friction with only two runtime dependencies (requests and requests-oauthlib). However, the package is abandoned—last release was 2021-07-16, over 1855 days ago. Maintenance status is inactive, so security patches and API updates are unlikely.
Requires Python 3.5 or later. You must obtain Twitter API credentials (Consumer Key, Consumer Secret, and OAuth tokens) from https://apps.twitter.com before authenticating.
License in practice
Licensed under MIT (permissive), so you can use, modify, and distribute Twython freely in commercial and private projects without significant legal restriction.
Quickstart
pip install twython
from twython import Twython
twitter = Twython(APP_KEY, APP_SECRET, OAUTH_TOKEN, OAUTH_TOKEN_SECRET)
twitter.update_status(status='See how easy using Twython is!')Verify before relying
- Whether Twitter API endpoints have changed since the last release in 2021 and whether Twython still works with current Twitter API versions
- Current state of OAuth token handling and whether Twitter's authentication flow changes are reflected in the codebase
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.5 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesrequestsrequests-oauthlib |
| Maintenance | Abandoned 1,855 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 122,345 / month, #11,956 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Topic :: Communications :: ChatTopic :: InternetTopic :: Software Development :: Libraries :: Python Modules |
Evidence: twython-3.9.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “twitter api client python”
- twythonTwython is a Python wrapper for the Twitter API that lets you query…
- python-twitterA Python wrapper that provides programmatic access to the Twitter…
- twitter-adsA Python SDK for managing Twitter Ads campaigns, accounts, and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also python-twitter · twikit · tweepy · rauth · Mastodon.py · twscrape · Scweet · twitchAPI · requests-oauth · pywa