{"id":14037320,"url":"https://github.com/alkihis/twitter-archive-reader","last_synced_at":"2025-04-06T13:08:58.824Z","repository":{"id":35090341,"uuid":"205389950","full_name":"alkihis/twitter-archive-reader","owner":"alkihis","description":"Full featured TypeScript Twitter archive reader and browser","archived":false,"fork":false,"pushed_at":"2024-11-18T21:49:45.000Z","size":1310,"stargazers_count":59,"open_issues_count":6,"forks_count":10,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-30T12:07:24.138Z","etag":null,"topics":["big-data","bigdata","tweets","twitter","twitter-archives"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alkihis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-30T13:40:31.000Z","updated_at":"2025-03-29T16:55:28.000Z","dependencies_parsed_at":"2024-12-31T16:11:52.258Z","dependency_job_id":"27a90144-bb2c-4cc2-86f2-bebba685d37c","html_url":"https://github.com/alkihis/twitter-archive-reader","commit_stats":{"total_commits":319,"total_committers":7,"mean_commits":45.57142857142857,"dds":0.1724137931034483,"last_synced_commit":"f9844d1fe25e554b0a5d8da98e757b7689ed714a"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alkihis%2Ftwitter-archive-reader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alkihis%2Ftwitter-archive-reader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alkihis%2Ftwitter-archive-reader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alkihis%2Ftwitter-archive-reader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alkihis","download_url":"https://codeload.github.com/alkihis/twitter-archive-reader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247485287,"owners_count":20946398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["big-data","bigdata","tweets","twitter","twitter-archives"],"created_at":"2024-08-12T03:02:42.357Z","updated_at":"2025-04-06T13:08:58.798Z","avatar_url":"https://github.com/alkihis.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# twitter-archive-reader\n\n\u003e Read data from classic Twitter archive and GDPR archive\n\nExplore easily tweets, direct messages, medias and more from Twitter archives.\n\n*This is a JavaScript/TypeScript package available on `npm` that provides useful data structures concieved to manipulate Twitter archives.*\n**If you're looking for a graphical tool to explore archives without programming, take a look to [Archive Explorer](https://archive-explorer.com).**\n\n## Features\n\n### For all types of archives\n\n- Access tweets using date selectors (by month, interval)\n- Search in tweets with custom filters\n- Get a single tweet by ID\n- Access user data stored in archive, like screen name, name or profile picture\n\n### For GDPR archives\n\n- Access direct messages with query selectors (conversation, date, content, context around one message)\n- Access images and videos stored in archive\n- List of favorites, blocks, mutes, followers and followings\n- Screen name history\n- Lots of user-related data like interests, age information and email addresses\n- Data from views and interactions with ads on Twitter website/mobile app\n- Twitter moments\n- Subscribed and created lists\n\n[What's a GDPR archive ?](../../wiki#different-kinds-of-archives)\n\n## Usage\n\nThis package can be used inside a browser or in Node.js.\n\n### Getting ready\n\nFull documentation (version 6.x.x) is available on [GitHub Wiki](../../wiki). Take a look !\n\n### [Examples](./Examples.md)\n\nYou can find a bunch of usage examples in [this file](./Examples.md).\n\n### Linking archive files to `twitter-archive-reader` objects and properties\n\nYou can find a [link between files and directories inside raw Twitter archives to this package data structures here](./Files_to_structures.md). This can help you if you've found a intersting property in some file and you want to explore it with `twitter-archive-reader` !\n\n### Detailled type documentation\n\nIf you want to find a type definition quickly, or get a detailled view of a data structure, [a automatically-generated documentation is available here](https://alkihis.fr/twitter-archive-reader).\n\n### About archive support\n\n- **Classic archives** are supported in every version of this module\n  - Since **1.0.0**:\n    - Tweet read\n    - Basic user info read\n- **GDPR archives** basic support since 1.0.0:\n  - Since **1.0.0**:\n    - Tweet read\n    - DM read\n    - File size must be \u003c 2 GB\n  - Since **1.2.0**:\n    - Favorites\n    - Mutes\n    - Blocks\n  - Since **1.3.0**:\n    - DM images\n  - Since **1.4.1**:\n    - Support DM images nested in ZIP files (GDPR archives 1.1)\n  - Since **2.0.0**: \n    - GDPR archives are streamed: file size is no longer a limit.\n    - Screen name history\n  - Since **4.0.0**:\n    - Extended favorites\n    - Personalization data\n    - Email addresses\n    - Connected application\n    - Many other user data\n    - Ad data\n  - Since **4.0.7**:\n    - Support GDPR 1.2 archives (created since January 2020)\n  - Since **5.0.0**:\n    - Events in direct messages\n    - Read every type of media available in GDPR archives\n\n\n### Old documentation\n\nWiki for 2.x.x is available [here](./wiki_2_00/Home.md).\n\nWiki for 3.x.x is available [here](./wiki_3_00/Home.md).\n\nWiki for 4.x.x is available [here](./wiki_4_00/Home.md).\n\nDocumentation for 5.x.x is nearly the same as 6.0.0.\nUse current documentation for those versions.\n\n## Migrate from 2.x.x to 3.0.0\n\nMigration guide is available [here](../../wiki/Migrate-to-3.0.0).\n\n\n## Migrate from 3.x.x to 4.0.0\n\nMigration guide is available [here](../../wiki/Migrate-to-4.0.0).\n\n## Migrate from 4.0.x to 5.0.0\n\nMigration guide is available [here](../../wiki/Migrate-to-5.0.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falkihis%2Ftwitter-archive-reader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falkihis%2Ftwitter-archive-reader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falkihis%2Ftwitter-archive-reader/lists"}