Skip to content
Get packs

Tweepy

A Python library for working with the Twitter/X API.

GitHub Download v4.17.0
Stars
11.2k
Forks
4.5k
Licence
MIT
Language
Python
Last update
4 months ago
Type
Library

What it is

Tweepy is a Python library that wraps the Twitter API so Python programs can read and interact with Twitter data without building raw web requests by hand. Developers use it to write scripts or applications that work with tweets and accounts. The README is brief and mainly covers installation and links to the documentation.

  • Write a Python script that fetches tweets or account information through the Twitter API
  • Build an automated bot that interacts with Twitter/X from Python code
  • Use the asynchronous subpackage in an async Python application after installing the async extra

Great for

  • Python developers who want to access the Twitter API from their own code
  • People building bots or scripts that read or post on Twitter/X
  • Developers who want an async option via the tweepy.asynchronous subpackage

Not ideal for

  • Non-programmers looking for a ready-made app, since this is a code library
  • Projects that need a language other than Python, since the library is Python-only
  • Anyone who needs Twitter API access without an API account, since the README links to Twitter's own API documentation and access is governed by Twitter
Step-by-step guide: how to use TweepyInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Install with a package manager

    You'll need: Python (the README says the latest version and older non-end-of-life versions are supported; specific version not stated) · pip

    Install from PyPI

    pip install tweepy

    Install with async support

    pip install tweepy[async]
  2. 2

    Run it

    • Install the library with pip install tweepy
    • Get Twitter API credentials from the Twitter developer platform (per the linked Twitter API documentation)
    • Open the official documentation at tweepy.readthedocs.io for usage examples
    • Write a short Python script that uses the library to make a first API call
  3. 3

    Get the most out of it

    • Install the async extra if you plan to use the tweepy.asynchronous subpackage
    • Follow the official documentation for authentication and endpoint examples
    • Ask questions in the official Discord server linked from the README
    • Install the latest development version directly from GitHub if you need unreleased changes

Downloads

Source code (.zip)master branch · straight from GitHubRelease v4.17.08 files incl. tweepy-4.17.0.tar.gz.sigstore.jsonOfficial website & docswww.tweepy.org

Strengths

  • Installs from PyPI with a single pip command
  • Has an official documentation site and a Discord server for help
  • Released under the permissive MIT license

Trade-offs

  • The README is short, so most usage detail lives in external documentation
  • Usefulness depends on Twitter's API access terms, which are outside the project's control
  • Only the installation steps are shown in the provided README; no code examples appear

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.