Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Download/dump the data in your CoTweet standard account before it gets shut down
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

CoTweet Exporter

CoTweet Standard Edition, a Twitter client for businesses, is being shut down on 15 February 2012.

Irritatingly, CoTweet are not providing a way to export the data from your account. (Not cool, if you ask me.) This little Ruby application fills that gap.


  • Download the entire contents of your inbox, sent folder and archived messages folder to JSON files on your disk.
  • For every Twitter user you've communicated with, dumps the conversation history with that user. (This is CoTweet's best feature, because you can avoid getting embarrassed by saying the same thing again to the same person.)
  • ROFLscale concurrency using asynchronous network I/O. (Not that it was needed, of course -- I just felt like writing it with em-http-request and DG.)
  • Automatic retry of failed requests, to cope with CoTweet's loltastic API.

The JSON files are in the schema used by CoTweet's internal API. They are not documented, but the format is pretty self-explanatory.

To my knowledge, there aren't yet any tools to import this data (though of course you can grep through it if you need to). Let me know if you write something that uses the data.


$ git clone && cd cotweet-export
$ gem install bundler && bundle install
$ mkdir conversations
$ bin/cotweet-export

Tested with Ruby 1.9.2.


MIT License (see LICENSE).

Patches and pull requests welcome.

Something went wrong with that request. Please try again.