Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



This software tool allows to extract big collections of Twitter news-sharing users, their news tweets and the full data structure of the shared articles.

The application is automatic and self-powered so that it can be run for indefinitely long sessions.

Installation Guide


  • Python (>3.4.0) and pip
  • MongoDB
  • Twitter API keys
  • (optional) Face++ keys

Setting up the application

Clone the repository:

git clone

Inside the project folder initialize a python environment

virtualenv newsanalyzer-env

Activate it

source newsanalyzer-env/bin/activate

The install the requirements

pip install -r requirements.txt

Setting up keystore

If you don't have yet, obtain Twitter API credentials

Open credential.json and fill the values with your keys:

    "consumer_key" : "<twitter API consumer key>",
    "consumer_secret" : "<twitter API consumer secret>",
    "access_token" : "<twitter API access token>",
    "access_token_secret" : "<twitter API access token secret>",
    "faceplus_key" : "<face++ key (optional)>",
    "faceplus_secret" : "<face++ secret (optional)>"

Setting up database

  1. Download and install MongoDB
  2. Run command mongod to start a MongoDB server on localhost (may require priviledges)
  3. Run script inside application folder

Running the pipeline

In order to start collecting users, tweets and articles your database need to contain at least one article entity to feed the recursive pipeline.

You can run utils/ to get a set of initial seeds or you can download our pre-collected dataset.

Then run

You can’t perform that action at this time.