Skip to content
Otso

Import Twitter/X Archive

Prepare the archive

Section titled “Prepare the archive”
  1. Request your archive from Twitter and unzip it.
  2. Locate data/tweets.js and remove the JavaScript assignment to get pure JSON.

Run the import

Section titled “Run the import”
Terminal window
otso import twitter --archive ~/Downloads/twitter

Mapping

Section titled “Mapping”
  • Tweets → note
  • Retweets → repost
  • Favorites → like
  • Media URLs are resolved and downloaded.

Rate limits

Section titled “Rate limits”

If using the API, supply TWITTER_BEARER_TOKEN. Otso respects rate limit headers and retries with backoff.