Reddit Media & Images Scraper (Video, GIF, Gallery)

Here is one real result, with every field the actor returns:

{
  "mediaUrl": "https://i.redd.it/22429irjviih1.png",
  "mediaType": "image",
  "sourceDomain": "i.redd.it",
  "width": null,
  "height": null,
  "postId": "1vkgrdm",
  "postTitle": "[OC] Spotted the best numberplate ever in Belgium last week",
  "postFlair": null,
  "postDomain": "i.redd.it",
  "subreddit": "pics",
  "author": "ned78",
  "authorFullname": "t2_mkcqe",
  "score": 364,
  "numComments": 27,
  "numCrossposts": 1,
  "permalink": "https://www.reddit.com/r/pics/comments/1vkgrdm/oc_spotted_the_best_numberplate_ever_in_belgium/",
  "isNsfw": false,
  "isSpoiler": false,
  "createdAt": "2026-08-10T10:11:58.000Z",
  "observedAt": "2026-08-10T14:16:53.424Z",
  "error": null
}

The most complete Reddit media scraper available. It returns every media item Reddit exposes across images, videos, GIFs and gallery images, with the direct media URL, source domain, dimensions when available, and the full post context (title, flair, author, score, comments, crossposts, NSFW and spoiler flags), and can also capture off-Reddit media hosts.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor sweeps the subreddit feeds you name (or exact post URLs you paste), extracts every media item from each post, keeps only the media types you selected, and writes one normalized record per media item to the run's dataset. Gallery posts expand to one record per image. Each record carries the direct media URL, the media type, the source domain and the full post context so you can filter, download or catalog media at scale.

By default it also captures media hosted off Reddit (imgur, gfycat, redgifs, streamable). Turn includeExternal off to keep only Reddit-hosted media (i.redd.it, v.redd.it). Note that maxMedia counts media items, not posts.

Quickstart

Open the actor, paste this into the input, and press Run. It returns 10 media items from the hot feed of r/pics.

{
  "maxMedia": 10,
  "subreddits": ["pics"],
  "sort": "hot",
  "mediaTypes": ["image", "video", "gif", "gallery"],
  "includeExternal": true
}

Add more subreddits, or paste exact postUrls. Use sort and timeFilter to control the feed, and mediaTypes to keep only the kinds you want. All fields are optional.

Input reference

Field	Type	Required	Default	Description
subreddits	string[]	no	["pics"]	Subreddit names to pull media from, without the r/ prefix, for example pics, aww.
postUrls	string[]	no	[]	Exact Reddit post URLs to pull media from directly.
maxMedia	integer	no	10	Maximum number of media items (images, videos, GIFs, gallery images) to collect. Counts media items, not posts.
sort	enum	no	hot	Sort order for subreddit feeds: hot, new, top, rising.
timeFilter	enum	no	week	Time window for the top sort: hour, day, week, month, year, all. Ignored for other sorts.
mediaTypes	string[]	no	["image","video","gif","gallery"]	Which kinds of media to keep.
includeExternal	boolean	no	true	Also capture media hosted off Reddit (imgur, gfycat, redgifs, streamable). Turn off for Reddit-hosted media only.

You can combine subreddits and postUrls in a single run.

Output reference

One dataset item per media item. Types: string, integer, boolean, or null when the source value is absent.

Field	Type	Description
mediaUrl	string	Direct URL of the media file.
mediaType	string	Media type: image, video, gif, or gallery.
sourceDomain	string	Host serving the media, for example i.redd.it.
width	integer	Media width in pixels when Reddit reports it, else null.
height	integer	Media height in pixels when Reddit reports it, else null.
postId	string	ID of the post the media belongs to.
postTitle	string	Title of the post.
postFlair	string	Post flair text, or null.
postDomain	string	Domain Reddit attributes to the post.
subreddit	string	Subreddit name.
author	string	Post author username, or [deleted].
authorFullname	string	Reddit author fullname (for example t2_...), or null.
score	integer	Net score of the post.
numComments	integer	Number of comments on the post.
numCrossposts	integer	Number of crossposts of the post.
permalink	string	Permalink to the post.
isNsfw	boolean	true when the post is marked NSFW.
isSpoiler	boolean	true when the post is marked as a spoiler.
createdAt	string	Post creation timestamp (ISO 8601).
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"maxMedia": 10, "subreddits": ["pics"], "sort": "hot", "mediaTypes": ["image","video","gif","gallery"], "includeExternal": true}):

{
  "mediaUrl": "https://i.redd.it/22429irjviih1.png",
  "mediaType": "image",
  "sourceDomain": "i.redd.it",
  "width": null,
  "height": null,
  "postId": "1vkgrdm",
  "postTitle": "[OC] Spotted the best numberplate ever in Belgium last week",
  "postFlair": null,
  "postDomain": "i.redd.it",
  "subreddit": "pics",
  "author": "ned78",
  "authorFullname": "t2_mkcqe",
  "score": 364,
  "numComments": 27,
  "numCrossposts": 1,
  "permalink": "https://www.reddit.com/r/pics/comments/1vkgrdm/oc_spotted_the_best_numberplate_ever_in_belgium/",
  "isNsfw": false,
  "isSpoiler": false,
  "createdAt": "2026-08-10T10:11:58.000Z",
  "observedAt": "2026-08-10T14:16:53.424Z",
  "error": null
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~reddit-media-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"subreddits":["pics"],"maxMedia":25,"sort":"hot"}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~reddit-media-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"subreddits":["aww"],"sort":"top","timeFilter":"month","mediaTypes":["image","gallery"],"maxMedia":200}'

Apify CLI:

apify call scrapers_lat/reddit-media-scraper \
  --input '{"subreddits":["gifs"],"mediaTypes":["gif","video"],"includeExternal":false}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=500&limit=500"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per media record returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 media items per run. Upgrade for higher maxMedia.
• maxMedia counts media, not posts. A single gallery post can contribute many media records.

FAQ and troubleshooting

A run returned 0 records. Why? The feed may have no media in the selected mediaTypes, or the subreddit name may be wrong. Widen mediaTypes, change sort, or check the subreddit name. Zero-result runs are not charged.

How do I keep only Reddit-hosted media? Set includeExternal to false. The actor then returns only i.redd.it and v.redd.it media and skips imgur, gfycat, redgifs and streamable.

Does it expand galleries? Yes. A gallery post produces one record per image, each with its own mediaUrl.

Why are width and height null? Reddit does not always report dimensions for a media item, especially for some external hosts. Missing source values are returned as null, never invented.

How do I filter out NSFW media? Every record has an isNsfw flag. Filter the dataset on isNsfw = false after the run.

Is this an official Reddit tool? No. This actor is independent and has no affiliation with Reddit. It reads only data that is publicly available on reddit.com.

Related scrapers

• Reddit Posts Scraper: Posts from any subreddit.
• Reddit Comments Scraper: Comment trees from any post.
• Reddit User Scraper: A user's posts and comments.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with Reddit. Accesses only publicly available media data.