How to export your data from X (Twitter)

easy Wait: usually within a day, sometimes several

X (Twitter) is required to give you a copy of the data it holds about you, including posts and social activity and messages. The request itself is free, and arrives as .zip containing JavaScript files, not JSON. Typical wait: usually within a day, sometimes several.

Download an archive of your data

Step by step

  1. Open Settings, then Your account

    On the web rather than in the app. Settings and privacy, Your account, Download an archive of your data.

  2. Confirm your password

    You will be asked to re-enter it, and then to confirm a code sent by email or text.

  3. Request the archive

    There is one button and no options. You cannot choose a date range or a subset.

  4. Wait for the notification

    It arrives in the app and by email. Most people see it within a day; a large account can take several.

  5. Download it promptly

    The link expires after roughly a week and the request has to be made again from scratch.

  6. Open Your archive.html to browse it

    The archive ships with its own offline viewer. Note the space in the filename - that trips up a lot of scripts.

Worth knowing

Bookmarks are not included. Likes are, but only as a tweet id and its text, with no author and no date.
Long posts are stored twice: a truncated copy in the main file and the full text in note-tweet.js. Anything reading only the first one silently loses the body of every long post.
Media in the archive is downsized rather than original. The original URLs are in the data, but they only resolve while the post is still live.

Common questions

Why are the files in my X archive .js instead of .json?

Because the archive ships with an offline viewer that loads them as scripts. Each file is a JavaScript assignment - window.YTD.tweets.part0 = [ ... ] - wrapping otherwise ordinary JSON. A JSON parser fails on every one of them until that first line is stripped.

Does the X archive include direct messages?

Yes, in direct-messages.js for one-to-one conversations and direct-messages-group.js for group ones. They are in plain text.

Why are my old tweets truncated in the archive?

Two reasons. Retweets are stored as a 140-character summary beginning RT @, with no way to recover the original. Long posts are stored truncated in tweets.js with the full text in note-tweet.js, joined by id.

Are bookmarks in the X data archive?

No. Likes are included, bookmarks are not, and there is no way to request them.

What Muletto does with this export

Once your download arrives, open it in Muletto. The file is read in your browser, on your own machine - nothing is uploaded. You get a breakdown of what is inside, duplicate detection, and a browsable view of your photos, messages, timeline and records.

Open your export