Skip to content
//Video Downloader example\\

Save a direct video file link

A public .mp4 file link (Sintel trailer, CC BY) saved with its size and length.

Updated October 24, 2026

What this example returns

This example returns up to 10 videos.

The dataset’s “Downloads” view shows 11 columns: Thumbnail, Title, Site, Uploader, Seconds, Quality, Format, File, Bytes, Page, and Note. See every output field.

What each setting does

The input this example runs Video Downloader with. “Try this input” opens it in the console, where you can run it as-is or change any field first.

Video links videos

https://media.w3.org/2010/05/sintel/trailer.mp4

Links to public video pages (for example Vimeo, Dailymotion or YouTube), pages with an embedded video player, direct video files (.mp4, .webm, .mov) and HLS or DASH stream links (.m3u8, .mpd). A page with several videos gives one row per video. Videos that need a login, cookies, a password or a subscription,…

Maximum videos maxVideos

10

Stop after this many videos are saved. Pages with several videos count each video.

Preferred quality preferredQuality

720p

Highest picture size to download. When the video has no exact match, the closest available size is used. Direct video files are saved at their own size.

Preferred format preferredFormat

MP4 video

Format of the saved file. MP4, MKV, MOV and WebM keep the original streams when they fit; other formats are converted.

Save the file saveFile

Yes

Save each video in this run's storage and add a download link (valid for 7 days). Turn this off to get the video details and direct stream links only. One saved file can be up to 90 MB, the storage limit for a single file; larger videos return their stream links and a note, so pick a lower quality to save them.

Name the file with filenameTemplateParts

title

Parts added after the site and video id, separated by underscores. Names are shortened to 252 characters.

Include subtitles includeSubtitles

No

Add the video's own subtitle text when the site publishes a track (WebVTT or SRT as published, English first). Speech-to-text is not included.

.json
{
  "videos": [
    {
      "url": "https://media.w3.org/2010/05/sintel/trailer.mp4"
    }
  ],
  "maxVideos": 10,
  "preferredQuality": "720p",
  "preferredFormat": "mp4",
  "saveFile": true,
  "filenameTemplateParts": [
    "title"
  ],
  "includeSubtitles": false
}

What it costs

You pay for the events the actor reports, such as each result or page it produces, plus the platform usage of your runs: compute, proxies and storage. Platform usage is typically about $6.15 per 1,000 results.

  • Saved megabyte$0.001Each megabyte downloaded for a saved file, rounded up.
  • Video$0.01Each video in the dataset, with or without a saved file.

Full pricing

When to use this example

From the Video Downloader readme:

Known limit

YouTube: single video links only, not channel, playlist or search pages.

Other ways to run Video Downloader

All examples of Video Downloader

About Video Downloader

Download public videos from Vimeo, Dailymotion, pages with an embedded player and direct video or stream links. Pick a quality and a format; each file is saved with the run and gets a download link.

Price:
$10.00 / 1,000 results
Developer:
Echofield
Categories:
Videos, Social media

Video Downloader pageOutput fieldsPricing

Related actors

//From the blog\\

Latest articles

All articles

The internet is full of data.
Start owning yours.

Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes.

No credit card. No setup calls.