Skip to main content

Write tweets to database

Project description

[![Downloads](]( [![Downloads](](

Download tweets into a CouchDB database


  • Flexible: works with any Twitter endpoint (REST API or Streaming API).
  • Geocode lookup for the Twitter user location using Google’s Map geocode service.
  • Uses CouchDB for storage.



The first time the script is executed the database is created. For example, to store tweets in a database called “tw_test” and to stream tweets that contain “pizza”, run this command:

python -m TweetBase.TweetBase
-couchurl -dbname tw_test -endpoint statuses/filter -parameters track=pizza

The TweetBase script downloads tweets and stores them into the specified database. Tweet meta data is stored separately from the user meta data. This is done so user data is only stored once in the database. The two types of records are differentiated by the “type” field, which is either TWITTER_STATUS or TWITTER_USER.

The same time that a new database is created, some views are also created. These views are:

  • get_tweets
  • get_users
  • count_type

In the client_examples folder you will find a Python example and a JavaScript example that uses these views to retrieve data.


  • TwitterAPI
  • TwitterGeoPics
  • couchdb

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for TweetBase, version 0.2.12
Filename, size File type Python version Upload date Hashes
Filename, size TweetBase-0.2.12.tar.gz (6.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page