Skip to content
A framework for observing Twitter through interactive networks.
Python JavaScript HTML CSS
Branch: master
Clone or download

Latest commit

Armin Pournaki
Armin Pournaki Fix bug in visualizer
Fix error that occurs when reading first and last line of certain tweet files based on char length.
Latest commit cca8644 Mar 14, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
src Prepare release 0.1.0. Mar 7, 2020
.gitignore Add twitter explorer open beta Mar 7, 2020
LICENSE Add twitter explorer open beta Mar 7, 2020
requirements.txt Add twitter explorer open beta Mar 7, 2020

twitter explorer
version python-version license

An interface to explore Twitter data through interactive network visualizations, created by Armin Pournaki in the context of the Odycceus project.


The twitter explorer helps computational social scientists to:

  • Collect Twitter data by providing a visual interface for the Twitter Search API.

  • Transform the collected data into networks: retweet networks capturing the interaction between users and hashtag networks revealing the semantic layer of the debate.

  • Explore these networks interactively by using state-of-the-art network visualizations.

Quick start

The twitter explorer requires Python ≥ 3.6. If you meet this requirement, open a terminal in your preferred folder to clone the repo and install the required libraries:

$ git clone
$ pip3 install -r requirements.txt

You can now run the collector and the visualizer:

$ streamlit run
$ streamlit run

They will open in a new window and instructions will follow.

Getting started

Please refer to the documentation for detailed installation instructions and how to use the twitter explorer.



Data protection

The twitter explorer facilitates the collection of data through the Twitter Search API. Please respect the developer agreement when handling the collected data. Our interface includes a privacy option that allows to remove all accessible metadata of users that have less than 5000 followers (no public figures) from the interactive visualization in order to comply with current privacy standards. By only displaying tweets that still exist at the time of exploration, the interface complies with Twitter's display requirements.

Future development

  • Add progress bar for collector
  • Incorporate dynamics of the retweet networks
  • Add different graph measures

How to cite

Please cite our paper if you use the twitter explorer in your research:
Pournaki, A., Gaisbauer, F., Banisch, S., Olbrich, E., The twitter explorer: a framework for observing Twitter through interactive networks.

Related software

    A powerful tool for streaming real-time tweets and storing them in an SQL database

  • twarc
    A CLI for Twitter search/streaming API


The idea for the twitter explorer originated from fruitful discussions in the context of the Odycceus project between Armin Pournaki, Felix Gaisbauer, Sven Banisch and Eckehard Olbrich. The tool is designed and developed by Armin Pournaki.


The twitter explorer stands on the shoulders of giants:

  • Streamlit
    The frontends of the collector and visualizer are made with Streamlit, a powerful and easily accessible tool to create interactive Python applications.
  • force-graph
    The interactive graph visualization relies on the force-graph library.
  • igraph
    All the graph operations in the twitter explorer are handled by the Python version of igraph.
  • tweepy
    An easy-to-use Python wrapper for Twitter API.


This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement No 732942.


The twitter explorer is licensed under the GNU GPLV3 license.

You can’t perform that action at this time.