whatisgithub

What is twint?

twintproject/twint — explained in plain English

Analysis updated 2026-06-24

16,373PythonAudience · researcherComplexity · 2/5Setup · moderate

In one sentence

A Python command-line tool that scrapes Twitter without needing an API key, letting you collect tweets, follower lists, and profile data in bulk with no official rate limits or account registration required.

Mindmap

mindmap
  root((Twint))
    What It Does
      Scrapes Twitter
      No API key needed
      No rate limits
    Data You Can Get
      User tweets
      Followers and following
      Liked tweets
      Emails and phones
    Output Formats
      CSV and JSON
      SQLite database
      Elasticsearch
    Audience
      Journalists
      Researchers
      OSINT analysts
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Collect all tweets from a specific Twitter user going back further than the 3,200-tweet API cap

USE CASE 2

Pull historical tweets matching a keyword or hashtag for sentiment analysis or journalism research

USE CASE 3

Build an OSINT report on a Twitter account including followers, following, and liked tweets

USE CASE 4

Export tweet data to CSV, JSON, or SQLite for analysis in Python or a spreadsheet

What is it built with?

PythonSQLiteElasticsearchDocker

How does it compare?

twintproject/twintlukas-blecher/latex-ocrtirth8205/code-review-graph
Stars16,37316,37416,360
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity2/52/53/5
Audienceresearcherresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Web-scraping approach may break if Twitter changes its site structure, not using the official API means no guarantees of stability.

So what is it?

Twint, also called the Twitter Intelligence Tool, is a Python tool for pulling data from Twitter without going through Twitter's official API. Normally, if you want a program to read tweets, you have to register a developer account, get API keys, and live within rate limits and a hard 3,200-tweet history cap per user. Twint sidesteps that by talking to Twitter's public search and profile pages directly, the README's tagline is "No authentication. No API. No limits." The tool wraps Twitter's search operators so you can collect every tweet from a specific user, every tweet that contains a keyword or hashtag, tweets sent in a certain date range, tweets near a geographic location, tweets from verified users only, and so on. It can also walk a user's followers, who they follow, and the tweets they have liked, and it can pull out sensitive-looking strings like emails and phone numbers. Results can be printed, written to a text file, exported as CSV or JSON, stored in a SQLite database, or pushed into Elasticsearch (with optional dashboards in Kibana). You can drive it from the command line or import it as a Python module and configure a Config object in code. There is also a graph-visualisation feature and an experimental tweet-translation mode. You would reach for Twint for open-source intelligence (OSINT) work, journalism, academic research on social media, or any project where you need a lot of historical tweets and the official API's quotas get in your way. It is installed with pip and there is also a Docker image. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Write a Python script using Twint to collect all tweets from a specific user over the past year and export them to CSV
Prompt 2
How do I use Twint to search for tweets about a topic in a specific city and save results to SQLite?
Prompt 3
Using Twint, how can I pull a list of followers for a Twitter account and store them in a JSON file?
Prompt 4
Walk me through running Twint with Elasticsearch so I can visualize tweet volume over time in Kibana
Prompt 5
How do I use Twint in Python code (not command line) to collect tweets matching a hashtag?

Frequently asked questions

What is twint?

A Python command-line tool that scrapes Twitter without needing an API key, letting you collect tweets, follower lists, and profile data in bulk with no official rate limits or account registration required.

What language is twint written in?

Mainly Python. The stack also includes Python, SQLite, Elasticsearch.

How hard is twint to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is twint for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.