Reddit Media Downloader

🎬 Turn Reddit media URLs into ready-to-use links

Built for developers, researchers, and content teams, this Actor takes public Reddit post URLs, profile-post URLs, or direct Reddit media URLs and returns source-hosted links for video, image, GIF, gallery, and available external media. It also returns media details and basic post context, so you can open or download the source without storing the files here.

• Get media links from public Reddit sources with Reddit Downloader.
• Get a direct video link from a post with Reddit Video Downloader Bot.
• Get a photo link from a public Reddit source with Reddit Photo Downloader.
• Save a GIF link from a public Reddit source with Download Reddit GIF.
• Open a video source URL with Reddit Video Link.

📦 Reddit media results

Each successful dataset row contains one media link. It can include the submitted URL, a main download URL, media type, source host, format, dimensions, duration, quality, codec, bitrate, frame rate, file size, thumbnail, post context, classification, gallery position, external provider details, and video streams. The output also has an errors field for submitted sources that could not be found or loaded.

What the rows give you

The Actor returns source-hosted URLs. It does not download, mirror, or store the media files. A gallery item gets its own row, and a video can include several video variants, separate audio streams, and subtitle streams when the source provides them.

▶️ Run from a URL list

Choose the target that matches every URL in the run. Add one or more public Reddit URLs, select the media types to return, and decide whether post targets may include external media. You can also set a media result limit. Start the run, then open the dataset link in the output.

Run steps

1. Set target to postUrls, profilePostUrls, or mediaUrls.
2. Add one or more public URLs under sourceUrls.
3. Choose mediaTypes and, for post or profile-post targets, whether to include external media.
4. Optionally set maxItems, then run the Actor.

⚙️ Input

Input fields

Field	Type	What it does
target	string	Chooses the URL kind for this run: postUrls, profilePostUrls, or mediaUrls. Every source URL must match it.
sourceUrls	array of objects	Adds one or more public Reddit URL objects to process.
sourceUrls[].url	string	The public Reddit post, profile-post, or direct media URL to process.
mediaTypes	array of strings	Chooses video, image, gif, or gallery media. If you omit it, the Actor returns all four types when they are available.
includeExternalMedia	boolean	For post and profile-post URLs, includes usable links and provider details for media hosted outside Reddit when set to true. It has no effect for direct Reddit media URLs. If false or omitted, only Reddit-hosted media is returned.
maxItems	integer	Optionally stops after this many media results. Leave it empty to return all available results until the sources are exhausted.

Input example

This is the public input from a successful current-beta run using the default example URL.

{
  "target": "postUrls",
  "sourceUrls": [
    {
      "url": "https://www.reddit.com/r/aww/comments/9x5mvy/14_years_young_a_little_older_a_little_wiser_but/"
    }
  ],
  "mediaTypes": [
    "video",
    "image",
    "gif",
    "gallery"
  ],
  "includeExternalMedia": false,
  "maxItems": 10
}

🧾 Output

Run output

Field	Type	What it does
dataset	string	Links to the dataset with successful source-hosted media links.
errors	string	Contains a JSON list of submitted sources that could not be found or loaded. Those sources are not in the dataset.

Complete dataset fields

Every successful dataset row uses this field set. Nested fields use dotted paths in the table, while JSON examples keep their real nested objects.

Field	Type	What it does
sourceUrl	string	The submitted public URL that led to this media link.
downloadUrl	string	The main source-hosted URL for opening or downloading the media.
mediaType	string	The media category: video, image, gif, gallery, or external.
format	string	The available file format, such as mp4, jpeg, or gif, when provided.
dimensions	object	Groups the media width and height in pixels, when available.
dimensions.width	integer	Media width in pixels, when available.
dimensions.height	integer	Media height in pixels, when available.
durationSeconds	number	Media duration in seconds, when available.
quality	string	The source quality label, when available.
codec	string	The media codec, when available.
bitrateKbps	number	Media bitrate in kilobits per second, when available.
frameRateFps	number	Video frame rate in frames per second, when available.
fileSizeBytes	integer	Media file size in bytes when the source provides it.
thumbnailUrl	string	A preview image URL for the media, when available.
sourceHost	string	The host that serves the main media URL.
post	object	Groups available context for the Reddit post linked to the media.
post.title	string	The Reddit post title, when post context is available.
post.author	string	The Reddit account that made the post, when available.
post.subreddit	string	The subreddit where the post was published, when available.
post.permalink	string	The canonical Reddit URL for the post, when available.
post.createdAt	string	The post creation time, when available.
post.score	integer	The Reddit post score, when available.
post.commentCount	integer	The number of comments on the post, when available.
post.thumbnailUrl	string	A thumbnail URL supplied for the post, when available.
classification	object	Groups post and media labels supplied by the source.
classification.isNsfw	boolean	Whether the source marks the post as not safe for work.
classification.isSpoiler	boolean	Whether the source marks the post as a spoiler.
classification.flair	string	The Reddit post flair, when available.
gallery	object	Groups the position of a result in a Reddit gallery.
gallery.itemIndex	integer	The one-based position of this item in a gallery, when available.
gallery.itemCount	integer	The number of items in the gallery, when available.
external	object	Groups provider details for media hosted outside Reddit.
external.provider	string	The external media provider name, when available.
external.pageUrl	string	A public provider page for the external media, when available.
video	object	Groups video renditions and related streams.
video.variants	array of objects	Available progressive or adaptive video renditions.
video.variants[]	object	One downloadable video rendition.
video.variants[].url	string	The source URL for a video rendition.
video.variants[].streamType	string	Whether the rendition is progressive or adaptive.
video.variants[].quality	string	The rendition quality label, when available.
video.variants[].width	integer	Rendition width in pixels, when available.
video.variants[].height	integer	Rendition height in pixels, when available.
video.variants[].format	string	Rendition file format, when available.
video.variants[].codec	string	Rendition codec, when available.
video.variants[].bitrateKbps	number	Rendition bitrate in kilobits per second, when available.
video.variants[].frameRateFps	number	Rendition frame rate in frames per second, when available.
video.audioStreams	array of objects	Separate source audio files for a video, when available.
video.audioStreams[]	object	One downloadable audio stream.
video.audioStreams[].url	string	The source URL for an audio stream.
video.audioStreams[].format	string	Audio file format, when available.
video.audioStreams[].codec	string	Audio codec, when available.
video.audioStreams[].bitrateKbps	number	Audio bitrate in kilobits per second, when available.
video.audioStreams[].sampleRateHz	integer	Audio sample rate in hertz, when available.
video.audioStreams[].channels	integer	Number of audio channels, when available.
video.audioStreams[].language	string	Audio language, when available.
video.subtitleStreams	array of objects	Separate source subtitle or caption files for a video, when available.
video.subtitleStreams[]	object	One downloadable subtitle stream.
video.subtitleStreams[].url	string	The source URL for a subtitle stream.
video.subtitleStreams[].language	string	Subtitle language, when available.
video.subtitleStreams[].format	string	Subtitle file format, when available.
video.subtitleStreams[].label	string	The source label for a subtitle stream, when available.

Genuine default-input row

{
  "post": {
    "title": "14 Years Young. A little older, a little wiser but still a puppy at heart. Say hi to Sevo",
    "author": "vahep",
    "subreddit": "aww",
    "permalink": "https://www.reddit.com/r/aww/comments/9x5mvy/14_years_young_a_little_older_a_little_wiser_but/",
    "createdAt": "2018-11-14T23:50:54.000Z",
    "score": 6848,
    "commentCount": 43,
    "thumbnailUrl": "https://b.thumbs.redditmedia.com/I6vqj_81jDnFc5Sr2AadJGcOQAxlELyTaIGw6SVAuQs.jpg"
  },
  "classification": {
    "isNsfw": false,
    "isSpoiler": false
  },
  "thumbnailUrl": "https://b.thumbs.redditmedia.com/I6vqj_81jDnFc5Sr2AadJGcOQAxlELyTaIGw6SVAuQs.jpg",
  "sourceUrl": "https://www.reddit.com/r/aww/comments/9x5mvy/14_years_young_a_little_older_a_little_wiser_but/",
  "downloadUrl": "https://i.redd.it/quq0aq26wdy11.jpg",
  "mediaType": "image",
  "format": "jpeg",
  "dimensions": {
    "width": 1768,
    "height": 2048
  },
  "fileSizeBytes": 501569,
  "sourceHost": "i.redd.it"
}

Direct media fields

Direct image and GIF URLs return the common media fields below. Optional fields appear when the source provides them.

Field	Type	What it does
sourceUrl	string	The direct Reddit media URL submitted for the run.
downloadUrl	string	The source-hosted URL for opening or downloading the media.
mediaType	string	Identifies the media as image or gif in these examples.
format	string	Identifies the file format.
dimensions.width and dimensions.height	integers	Give the media size in pixels when available.
fileSizeBytes	integer	Gives the file size when the source provides it.
sourceHost	string	Names the host serving the media URL.

{
  "sourceUrl": "https://i.redd.it/tse4kv1cb7hh1.gif",
  "downloadUrl": "https://i.redd.it/tse4kv1cb7hh1.gif",
  "mediaType": "gif",
  "format": "gif",
  "fileSizeBytes": 765681,
  "sourceHost": "i.redd.it"
}

Post context fields

Post and profile-post URLs can add the post and classification objects to a media row. The complete nested field definitions are in the dataset table above.

Field	Type	What it does
post	object	Groups the Reddit title, author, subreddit, permalink, creation time, score, comment count, and post thumbnail.
classification	object	Groups NSFW, spoiler, and flair labels supplied by the source.
thumbnailUrl	string	Gives a preview image for the media when available.

{
  "post": {
    "title": "14 Years Young. A little older, a little wiser but still a puppy at heart. Say hi to Sevo",
    "author": "vahep",
    "subreddit": "aww",
    "permalink": "https://www.reddit.com/r/aww/comments/9x5mvy/14_years_young_a_little_older_a_little_wiser_but/",
    "createdAt": "2018-11-14T23:50:54.000Z",
    "score": 6848,
    "commentCount": 43,
    "thumbnailUrl": "https://b.thumbs.redditmedia.com/I6vqj_81jDnFc5Sr2AadJGcOQAxlELyTaIGw6SVAuQs.jpg"
  },
  "classification": {
    "isNsfw": false,
    "isSpoiler": false
  },
  "thumbnailUrl": "https://b.thumbs.redditmedia.com/I6vqj_81jDnFc5Sr2AadJGcOQAxlELyTaIGw6SVAuQs.jpg",
  "sourceUrl": "https://www.reddit.com/r/aww/comments/9x5mvy/14_years_young_a_little_older_a_little_wiser_but/",
  "downloadUrl": "https://i.redd.it/quq0aq26wdy11.jpg",
  "mediaType": "image",
  "format": "jpeg",
  "dimensions": {
    "width": 1768,
    "height": 2048
  },
  "fileSizeBytes": 501569,
  "sourceHost": "i.redd.it"
}

Gallery fields

Gallery media uses the common media fields plus the position of the saved item in the source gallery.

Field	Type	What it does
gallery.itemIndex	integer	Gives the one-based position of this gallery item.
gallery.itemCount	integer	Gives the number of items in the gallery.

{
  "post": {
    "title": "I found an awesome print and I cannot read the signature!",
    "author": "mehhgb",
    "subreddit": "Whatisthis",
    "permalink": "https://www.reddit.com/r/Whatisthis/comments/1g95lsd/i_found_an_awesome_print_and_i_cannot_read_the/",
    "createdAt": "2024-10-22T00:41:54.000Z",
    "score": 2,
    "commentCount": 1,
    "thumbnailUrl": "https://b.thumbs.redditmedia.com/ehVlWb-ee2qFWFp1CvlIASzoU2_-msPLuPlnevV3RUg.jpg"
  },
  "classification": {
    "isNsfw": false,
    "isSpoiler": false,
    "flair": "Open"
  },
  "thumbnailUrl": "https://b.thumbs.redditmedia.com/ehVlWb-ee2qFWFp1CvlIASzoU2_-msPLuPlnevV3RUg.jpg",
  "sourceUrl": "https://www.reddit.com/r/Whatisthis/comments/1g95lsd/i_found_an_awesome_print_and_i_cannot_read_the/",
  "downloadUrl": "https://i.redd.it/ml29wpa2f7wd1.jpg",
  "mediaType": "gallery",
  "format": "jpeg",
  "dimensions": {
    "width": 2798,
    "height": 1730
  },
  "fileSizeBytes": 416241,
  "sourceHost": "i.redd.it",
  "gallery": {
    "itemIndex": 1,
    "itemCount": 2
  }
}

External media fields

When external media is included for a post or profile-post target, the row can include the provider name and its public page URL.

Field	Type	What it does
external.provider	string	Names the external media provider.
external.pageUrl	string	Links to the public provider page for the media.

{
  "post": {
    "title": "Blanche now meeting Epstein survivors while trying to get confirmed is 'insulting': Oversight Rep.",
    "author": "AdSpecialist6598",
    "subreddit": "videos",
    "permalink": "https://www.reddit.com/r/videos/comments/1uz8vst/blanche_now_meeting_epstein_survivors_while/",
    "createdAt": "2026-07-17T19:01:36.000Z",
    "score": 874,
    "commentCount": 24,
    "thumbnailUrl": "https://external-preview.redd.it/lYJyOpM_ziu6qiYbXyzDug7iU7merYRJ2aUZWCw1uNM.jpeg?width=140&height=105&auto=webp&s=4a693618346467d90d2432c584b84e4c3d41aa14"
  },
  "classification": {
    "isNsfw": false,
    "isSpoiler": false
  },
  "thumbnailUrl": "https://external-preview.redd.it/lYJyOpM_ziu6qiYbXyzDug7iU7merYRJ2aUZWCw1uNM.jpeg?width=140&height=105&auto=webp&s=4a693618346467d90d2432c584b84e4c3d41aa14",
  "sourceUrl": "https://www.reddit.com/r/videos/comments/1uz8vst/blanche_now_meeting_epstein_survivors_while/",
  "downloadUrl": "https://www.youtube.com/watch?v=AMGdYH9IIGY&pp=ygUGbXMgbm93",
  "mediaType": "external",
  "sourceHost": "www.youtube.com",
  "external": {
    "provider": "www.youtube.com",
    "pageUrl": "https://www.youtube.com/watch?v=AMGdYH9IIGY&pp=ygUGbXMgbm93"
  }
}

Video stream fields

Video rows can include the main media details plus progressive or adaptive variants, separate audio, and subtitle streams.

Field	Type	What it does
video.variants	array of objects	Lists available video renditions.
video.variants[].url	string	Links to one video rendition.
video.variants[].streamType	string	Shows progressive or adaptive.
video.variants[].quality	string	Gives the rendition quality label.
video.variants[].width and video.variants[].height	integers	Give the rendition size in pixels.
video.variants[].format	string	Gives the rendition file format.
video.variants[].codec	string	Gives the rendition codec when available.
video.variants[].bitrateKbps	number	Gives the rendition bitrate when available.
video.variants[].frameRateFps	number	Gives the rendition frame rate when available.
video.audioStreams	array of objects	Lists separate audio files when available.
video.audioStreams[].url	string	Links to one audio stream.
video.audioStreams[].format	string	Gives the audio format when available.
video.audioStreams[].codec	string	Gives the audio codec when available.
video.audioStreams[].bitrateKbps	number	Gives the audio bitrate when available.
video.audioStreams[].sampleRateHz	integer	Gives the audio sample rate when available.
video.audioStreams[].channels	integer	Gives the number of audio channels when available.
video.audioStreams[].language	string	Gives the audio language when available.
video.subtitleStreams	array of objects	Lists subtitle or caption files when available.
video.subtitleStreams[].url	string	Links to one subtitle stream.
video.subtitleStreams[].language	string	Gives the subtitle language when available.
video.subtitleStreams[].format	string	Gives the subtitle format when available.
video.subtitleStreams[].label	string	Gives the source label when available.

{
  "sourceUrl": "https://v.redd.it/u5pu7ad5rcdh1",
  "downloadUrl": "https://v.redd.it/u5pu7ad5rcdh1/CMAF_720.mp4",
  "mediaType": "video",
  "format": "mp4",
  "dimensions": {
    "width": 720,
    "height": 1280
  },
  "durationSeconds": 13,
  "quality": "1280p",
  "codec": "avc1.4d401f",
  "bitrateKbps": 2083.898,
  "frameRateFps": 30,
  "fileSizeBytes": 3260125,
  "sourceHost": "v.redd.it",
  "video": {
    "variants": [
      {
        "url": "https://v.redd.it/u5pu7ad5rcdh1/CMAF_220.mp4",
        "streamType": "adaptive",
        "quality": "392p",
        "height": 392,
        "width": 220,
        "format": "mp4",
        "codec": "avc1.4d401e",
        "bitrateKbps": 184.218,
        "frameRateFps": 30
      },
      {
        "url": "https://v.redd.it/u5pu7ad5rcdh1/CMAF_270.mp4",
        "streamType": "adaptive",
        "quality": "480p",
        "height": 480,
        "width": 270,
        "format": "mp4",
        "codec": "avc1.4d401e",
        "bitrateKbps": 359.506,
        "frameRateFps": 30
      },
      {
        "url": "https://v.redd.it/u5pu7ad5rcdh1/CMAF_360.mp4",
        "streamType": "adaptive",
        "quality": "640p",
        "height": 640,
        "width": 360,
        "format": "mp4",
        "codec": "avc1.4d401e",
        "bitrateKbps": 763.1,
        "frameRateFps": 30
      },
      {
        "url": "https://v.redd.it/u5pu7ad5rcdh1/CMAF_480.mp4",
        "streamType": "adaptive",
        "quality": "854p",
        "height": 854,
        "width": 480,
        "format": "mp4",
        "codec": "avc1.4d401f",
        "bitrateKbps": 1097.942,
        "frameRateFps": 30
      },
      {
        "url": "https://v.redd.it/u5pu7ad5rcdh1/CMAF_720.mp4",
        "streamType": "adaptive",
        "quality": "1280p",
        "height": 1280,
        "width": 720,
        "format": "mp4",
        "codec": "avc1.4d401f",
        "bitrateKbps": 2083.898,
        "frameRateFps": 30
      }
    ],
    "audioStreams": [
      {
        "url": "https://v.redd.it/u5pu7ad5rcdh1/CMAF_AUDIO_64.mp4",
        "format": "mp4",
        "codec": "mp4a.40.2",
        "bitrateKbps": 66.1,
        "sampleRateHz": 48000,
        "channels": 2
      },
      {
        "url": "https://v.redd.it/u5pu7ad5rcdh1/CMAF_AUDIO_128.mp4",
        "format": "mp4",
        "codec": "mp4a.40.2",
        "bitrateKbps": 129.825,
        "sampleRateHz": 48000,
        "channels": 2
      }
    ],
    "subtitleStreams": []
  }
}

💳 Pricing

This Actor uses pay-per-event pricing. Each successful media link saved to the dataset uses one charged event. Check the Apify Console for the current price for your account and tier.

Charged event

Event	What it covers
Media link	One successful source-hosted media link with available details is saved.

🔌 Integrations

Use the Apify API to start runs, read dataset results, and connect this Actor to your own workflow. You can also use Apify schedules and webhooks for repeat runs and follow-up actions.

❓ FAQ

What can I submit?

Set target to match the URLs you submit. You can use public Reddit post URLs, profile-post URLs, or direct Reddit media URLs.

Can I use a profile-post URL?

Yes. Set target to profilePostUrls and add public profile-post URLs under sourceUrls.

Can I use a direct Reddit media URL?

Yes. Set target to mediaUrls for a direct URL from a Reddit media host. The row can contain media details without post context.

How do I include media hosted outside Reddit?

Set includeExternalMedia to true for post or profile-post targets. This option has no effect for direct Reddit media URLs. When it is off, the Actor returns Reddit-hosted media only.

How are gallery posts returned?

Each available gallery item is saved as its own media row. Use gallery.itemIndex and gallery.itemCount to place it in the source gallery.

Do video rows include sound and subtitles?

When the source provides them, a video row can include several video variants, separate audio streams, and subtitle or caption streams.

What happens when a source cannot be loaded?

The source is listed in the errors output field instead of being added as a successful dataset row.

How does maxItems work?

It stops the run after the chosen number of media results. Leave it empty to return all available results until the sources are exhausted.

Do I need a Reddit login?

No. The Actor processes publicly accessible Reddit sources without requiring a Reddit login.

Does this Actor download the media files?

No. It returns source-hosted URLs that you can open or download. It does not mirror or store the media files.

📝 Changelog

0.0: Initial release

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• Reddit Scraper - Collect broader public Reddit posts, comments, communities, and user data when media links are part of a wider Reddit dataset.
• Reddit Post Media Downloader - Inspect individual subreddit or profile posts for direct media links, audio, and quality options.
• Reddit Media & Images Scraper (Video, GIF, Gallery) - Collect media from subreddit or post pages when you need discovery beyond submitted URLs.
• Reddit Media Downloader - Get Reddit-hosted image, gallery, GIF, and video or audio links from public post URLs.
• Reddit Media Search Scraper - Find media posts by keyword before sending exact URLs to a URL-based downloader.

Made with ❤️ by Maxime Dupré