Skip to content

ArthurHeitmann/arctic_shift

Repository files navigation

Project Arctic Shift

Making Reddit data accessible to researchers, moderators and everyone else.

Interact with the data through large dumps, an API or web interface.

Downloads

All download links are organized here. Once a new dump is available, it will also be added on the releases page.

Alternatively for downloading data of users or smaller subreddits, you can use this tool.

For information on how the data was collected and modified, see here.

API

Depending on your use case, you can try my (limited) API. For manual queries, you can use this tool.

Usage

First download one more dumps from the above links.

Generally I'd recommend to work with the compressed files instead of unpacking them. Unless of course you have seemingly infinite disk space.

With the helper scripts in this repository you can quickly get started. If you don't want to use those files or want to use a CLI tool, head over to the zst_blocks repository for processing .zst_blocks files.

For using the helper scripts:

(You need at least Python 3.10)

  1. Clone this repository
git clone https://github.com/ArthurHeitmann/arctic_shift.git
git submodule update --init
  1. Install the zstandard library
pip install zstandard
  1. Open scripts/processFiles.py in your editor. That script can process .zst_blocks, .zst and new line delimited .json files.

  2. Enter the path to a file or folder in fileOrFolderPath (since it is a raw string, you don't have to escape backslashes). If you enter a folder, all files in that folder will be processed.

  3. Add your code to the processRow function.

  4. Run the file and be (very) patient.

Contact & Removal requests

Removal requests and generic support requests can be submitted here. To check if your data is in the dataset, search for your username here.

Removal forms of other archives: Pushshift | PullPush | potentially archive.org.

If you have questions, you can DM me on reddit, discord (raiderbv if the link doesn't work) or email. Alternatively open an issue or pull request.

About

Making Reddit data accessible to researchers, moderators and everyone else. Interact with the data through large dumps, an API or web interface.

Topics

Resources

Stars

Watchers

Forks