Skip to main content

Unshorten the URLs in your Twitter archive

Project description


Twitter's archive download includes shortened URLs instead of the original URLs that you tweeted. If Twitter ever goes away, the server at won't be available to respond to requests.

twitter-archive-unshorten is a small Python program that will examine all the JavaScript files in the archive download and rewrite the short URLs to their original full URL form. This means the context for your archived tweets will make a little more sense after Twitter is gone. Maybe you can look up those URLs in the Internet Archive if they are no longer available. This would be impossible if all you had was the short URL.


$ pip3 install twitter-archive-unshorten


  1. Unzip your Twitter archive zip file.
  2. Open a terminal window and run: twitter-archive-unshorten /path/to/your/archive/directory/

It might take a while, depending on how many tweets you have. Once it's finished you should be able open your archive and interact with it without the URLs.

The mapping of short URLs to long URLs that was used is saved in your archive directory as data/shorturls.json.


If you'd like to develop further you can run the existing tests:

$ pip3 install pytest
$ pytest

Project details

Download files

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

Source Distribution

twitter_archive_unshorten-0.0.10.tar.gz (4.5 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page