Read data from classic Twitter archive and GDPR archive

Explore easily tweets, direct messages, medias and more from Twitter archives.

This is a JavaScript/TypeScript package available on npm that provides useful data structures concieved to manipulate Twitter archives. If you're looking for a graphical tool to explore archives without programming, take a look to Archive Explorer.

• Access tweets using date selectors (by month, interval)
• Search in tweets with custom filters
• Get a single tweet by ID
• Access user data stored in archive, like screen name, name or profile picture

• Access direct messages with query selectors (conversation, date, content, context around one message)
• Access images and videos stored in archive
• List of favorites, blocks, mutes, followers and followings
• Screen name history
• Lots of user-related data like interests, age information and email addresses
• Data from views and interactions with ads on Twitter website/mobile app
• Twitter moments
• Subscribed and created lists

What's a GDPR archive ?

This package can be used inside a browser or in Node.js.

Full documentation (version 6.x.x) is available on GitHub Wiki. Take a look !

You can find a bunch of usage examples in this file.

You can find a link between files and directories inside raw Twitter archives to this package data structures here. This can help you if you've found a intersting property in some file and you want to explore it with twitter-archive-reader !

If you want to find a type definition quickly, or get a detailled view of a data structure, a automatically-generated documentation is available here.

• Classic archives are supported in every version of this module
  • Since 1.0.0:
    • Tweet read
    • Basic user info read
• GDPR archives basic support since 1.0.0:
  • Since 1.0.0:
    • Tweet read
    • DM read
    • File size must be < 2 GB
  • Since 1.2.0:
    • Favorites
    • Mutes
    • Blocks
  • Since 1.3.0:
    • DM images
  • Since 1.4.1:
    • Support DM images nested in ZIP files (GDPR archives 1.1)
  • Since 2.0.0:
    • GDPR archives are streamed: file size is no longer a limit.
    • Screen name history
  • Since 4.0.0:
    • Extended favorites
    • Personalization data
    • Email addresses
    • Connected application
    • Many other user data
    • Ad data
  • Since 4.0.7:
    • Support GDPR 1.2 archives (created since January 2020)
  • Since 5.0.0:
    • Events in direct messages
    • Read every type of media available in GDPR archives

Wiki for 2.x.x is available here.

Wiki for 3.x.x is available here.

Wiki for 4.x.x is available here.

Documentation for 5.x.x is nearly the same as 6.0.0. Use current documentation for those versions.

Migration guide is available here.

Migration guide is available here.

Migration guide is available here.