Post Files

File URLs

Every post's files are named by the file's MD5, and stored in folders named after the first two pairs of characters:

File URL
Original https://static1.e621.net/data/f3/59/f3590a911a687c67c74fb4665a9635d3.webm
Preview https://static1.e621.net/data/preview/f3/59/f3590a911a687c67c74fb4665a9635d3.jpg
Sample https://static1.e621.net/data/sample/f3/59/f3590a911a687c67c74fb4665a9635d3.jpg
Video sample https://static1.e621.net/data/sample/f3/59/f3590a911a687c67c74fb4665a9635d3_480p.mp4
MP4 variant https://static1.e621.net/data/sample/f3/59/f3590a911a687c67c74fb4665a9635d3_alt.mp4

Formats

Post endpoints return one of two formats.

The default format has all of a post's files in a single files object:

{
  "files": {
    "meta": { "md5": "f3590a...", "ext": "webm", "size": 216387, "duration": 3.953, "has_sample": true },
    "original": { "width": 640, "height": 640, "url": "..." },
    "preview": { "width": 256, "height": 256, "jpg": "...", "webp": "..." },
    "sample": { "width": 850, "height": 850, "jpg": "...", "webp": "..." },
    "video": { "has": true, "original": { ... }, "variants": { ... }, "samples": { ... } }
  }
}

The mode parameter changes which fields are returned. thumbnail returns a flat, much smaller object with just what's needed to show a thumbnail (file_url, preview_url, sample_url, duration, and so on).

The legacy format, returned with v1=true, has file, preview, and sample objects instead. It's deprecated and will be removed, and mode is ignored with it:

{
  "file": { "width": 640, "height": 640, "ext": "webm", "size": 216387, "md5": "f3590a...", "url": "..." },
  "preview": { "width": 256, "height": 256, "url": "...", "alt": "..." },
  "sample": { "has": true, "width": 850, "height": 850, "url": "...", "alt": "...", "alternates": { ... } }
}

Video Files

Videos have extra files, in files.video (or sample.alternates in the legacy format):

Key What it is
original The original file
variants.mp4 / variants.webm The full resolution video converted to the other format
samples.720p / samples.480p Smaller MP4 versions. Only the sizes smaller than the original exist.

Each one has a url, width, height, size, fps, and codec. For the best compatibility, play the mp4 variant, or a sample on slow connections.

Hidden Files

File URLs are null when you can't see the post's files:

The post itself is still returned, so check for null before using a URL. The MD5 is still included, but building the URL yourself won't work for deleted posts, which are moved to a protected location.