Video Frame Extractor: Video URL to JPG, PNG & WebP Frames avatar

Video Frame Extractor: Video URL to JPG, PNG & WebP Frames

Pricing

$2.00 / 1,000 frame extracteds

Go to Apify Store
Video Frame Extractor: Video URL to JPG, PNG & WebP Frames

Video Frame Extractor: Video URL to JPG, PNG & WebP Frames

Extract frames from video file URLs with ffmpeg. Pick every N seconds, N evenly spaced frames, scene changes or exact timestamps. Get JPG, PNG or WebP images with public links, timestamps and sizes, ready for AI vision, thumbnails and video analysis.

Pricing

$2.00 / 1,000 frame extracteds

Rating

0.0

(0)

Developer

Atesen Software

Atesen Software

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

3 days ago

Last modified

Features

Limited permissions

Share

Give this Actor a link to a video file and it returns still images from it: one frame every N seconds, N evenly spaced frames, a frame at every scene change, or frames at exact timestamps. Every frame is saved as a JPG, PNG or WebP image with a public link, and every frame gets one dataset row with its timestamp, size and image URL.

Use it to feed video to AI vision models, to build video thumbnails and contact sheets, to sample training data for machine learning, to check video quality, or to turn a video into a set of pictures a person or a model can skim.

What it does

  • Extract frames from a video URL. The Actor downloads the file once, reads it with ffmpeg and cuts the frames you asked for.
  • Four ways to pick frames. Interval (every N seconds), count (N evenly spaced frames), scene changes (video keyframes at every cut, with a strength score) and exact timestamps.
  • Image output you control. JPG, PNG or WebP, maximum width (frames are scaled down, never up), JPG/WebP quality, start and end of the range.
  • Ready-to-use results. One dataset row per frame: videoUrl, frameIndex, timestampSec, imageUrl, width, height, bytes, mode. Open the images by link, or export the rows as JSON, CSV or Excel.
  • Many videos per run. Up to 200 URLs per run, each with its own result and error message.
  • No account on the video site, no proxy, no browser.

What it does not do

  • It reads direct links to video files only (the URL opens the .mp4, .webm, .mov, .mkv, .avi, .flv or .ts file itself). Page links from YouTube, Vimeo, TikTok, Instagram, Facebook, X and other video platforms are not supported, and the Actor does not try to download from them. Use a file you host (S3, Cloudflare R2, Google Cloud Storage, a CDN, your own server, Dropbox links ending in ?dl=1) or a file you are allowed to fetch.
  • It does not read streaming playlists (HLS .m3u8, DASH .mpd), DRM-protected files or videos behind a login.
  • It does not transcribe audio, recognise text or faces, or describe the pictures. It gives you the frames; send them to the AI model of your choice.
  • Local, private and internal addresses are blocked on purpose (see Security).

Input

FieldWhat it doesDefault
videoUrlsDirect video file URLs, one per line (up to 200).two sample clips
modeinterval, count, scenes or timestamps.interval
intervalSecondsInterval mode: seconds between frames.5
frameCountCount mode: how many frames per video.8
sceneThresholdScenes mode: sensitivity (0.15 very sensitive, 0.3 balanced, 0.5 hard cuts only).0.3
timestampsTimestamps mode: seconds (12.5) or clock time (1:30, 01:02:03.5).none
imageFormatjpg, png or webp.jpg
maxWidthLongest width in pixels; 0 keeps the original size.1280
quality1-100 for JPG and WebP.85
startSec / endSecOnly use this part of the video (not used by timestamps mode).whole video
maxFramesPerVideoSafety cap per video (1-1000).100
maxVideoSizeMbSkip files larger than this (1-1024 MB).200
downloadTimeoutSecsSkip a video that does not download in time.600

Example: one frame per second from the first minute of two videos, as WebP.

{
"videoUrls": ["https://example.com/demo.mp4", "https://example.com/tour.webm"],
"mode": "interval",
"intervalSeconds": 1,
"startSec": 0,
"endSec": 60,
"imageFormat": "webp",
"maxWidth": 960
}

Example: scene changes only, for an AI vision pipeline.

{ "videoUrls": ["https://example.com/ad.mp4"], "mode": "scenes", "sceneThreshold": "0.3", "maxFramesPerVideo": 30 }

Output

Each delivered frame is one dataset row:

{
"videoUrl": "https://www.w3schools.com/html/mov_bbb.mp4",
"frameIndex": 2,
"timestampSec": 4,
"imageUrl": "https://api.apify.com/v2/key-value-stores/<storeId>/records/v1-f0002-t4000ms.jpg",
"key": "v1-f0002-t4000ms.jpg",
"width": 320,
"height": 176,
"bytes": 5142,
"format": "jpg",
"mode": "interval",
"sceneScore": null,
"error": null
}
  • The images live in the run's key-value store; imageUrl is the link to each one. Keys read v<video number>-f<frame number>-t<milliseconds>.<format>.
  • A video that cannot be processed produces one row with an error text (for example "The video URL returned 404") and no image.
  • The key-value store also holds a SUMMARY record: per video the duration, size, frames delivered, notes (for example "3 timestamps are beyond the end of the video"), and why the run stopped.
  • Storage follows your Apify plan's data retention; download the frames you want to keep.

How the modes behave

  • Interval: frames at start, start + N, start + 2N, ... and never at or past the end of the video. If more than maxFramesPerVideo would result, it stops at the cap.
  • Count: the range is cut into N equal slices and the frame is taken from the middle of each, which avoids black first and last frames.
  • Scenes: the opening frame plus one frame at every detected cut. Each cut row carries sceneScore (0 to 1). If there are more cuts than maxFramesPerVideo, the strongest cuts are kept.
  • Timestamps: exactly the times you list, in time order. Times after the end of the video are skipped and reported in SUMMARY.

Use cases

  • Send video frames to GPT, Claude, Gemini or another vision model for captioning, moderation or search.
  • Build thumbnails, storyboards and preview images for a video library.
  • Collect frames for machine learning datasets (every N seconds or at scene changes).
  • Check what a video looks like at known moments (QA, compliance review, ad review).
  • Create keyframes for slide-style summaries of talks and demos.

Pricing and cost control

You pay for delivered frames (pay per event: one event per frame saved and returned as a dataset row). Videos that fail, blocked URLs, frames that cannot be decoded, and timestamps beyond the end of the video cost nothing. Set Maximum cost per run in the run options: the Actor stops cleanly at that limit and never delivers frames it could not charge.

Maximum items is a hard cap on charged rows. Set maxItems in the run options (or ?maxItems= in the API) and the run stops after that many frames: it never writes or charges more rows than that number. Leave it empty for no cap. Free status rows are not counted.

Security and limits

  • Only http and https URLs are fetched. The Actor refuses localhost, private network ranges, link-local and cloud metadata addresses, IPv6 equivalents and names that resolve to them, and it checks every redirect. Credentials inside a URL are not accepted.
  • Each video is downloaded to a temporary file first (size and time limits apply); ffmpeg only ever reads that local file, and the file type is verified before it is opened.
  • Limits: 200 URLs per run, files up to 1 GB (200 MB by default; the run disk is twice the run memory, so very large files need more memory), videos up to 120 minutes, pictures up to 4K (4096 x 2304 pixels; larger videos such as 8K are skipped for free), up to 1000 frames per video.
  • Only the frames you request are stored. The Actor collects no personal data. You are responsible for having the right to process the videos you submit, including any people or private content shown in them.
  • Privacy of the frame links: the images are stored in your run's key-value store and imageUrl is a link that opens the picture for anyone who holds it. Do not post the links of frames that show private or sensitive content, and delete the run's storage when you no longer need the images.

Use via API

One request runs the Actor, waits for it and returns the dataset items as JSON. Send your token in the Authorization header, not in the URL:

curl -X POST "https://api.apify.com/v2/acts/atesen-software~video-frame-extractor/run-sync-get-dataset-items?timeout=120" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"videoUrls":["https://www.w3schools.com/html/mov_bbb.mp4"],"mode":"interval","intervalSeconds":2,"imageFormat":"jpg"}'

The synchronous endpoint waits up to 300 seconds. For longer jobs start a run with POST https://api.apify.com/v2/acts/atesen-software~video-frame-extractor/runs and read the dataset when it finishes.

JavaScript (npm install apify-client):

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('atesen-software/video-frame-extractor').call({ videoUrls: ["https://www.w3schools.com/html/mov_bbb.mp4"], mode: "interval", intervalSeconds: 2, imageFormat: "jpg" });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Use with AI agents (MCP)

Claude Desktop, Cursor, VS Code and other MCP clients can call this Actor as a tool through the Apify MCP server. Load only this Actor with:

https://mcp.apify.com?tools=atesen-software/video-frame-extractor

Client config (sign in with Apify OAuth when the browser opens, or add an Authorization: Bearer <APIFY_TOKEN> header instead):

{
"mcpServers": {
"apify": { "url": "https://mcp.apify.com?tools=atesen-software/video-frame-extractor" }
}
}

Then ask in plain words, for example: "Extract one JPG frame every 2 seconds from https://www.w3schools.com/html/mov_bbb.mp4." The agent fills the same input fields you see on the Input tab, and runs are billed to your Apify account at the prices on the Pricing tab.

FAQ

Can I use a YouTube link? No. YouTube, Vimeo, TikTok, Instagram and similar pages are not supported. The Actor needs a link that opens the video file itself.

Why did my link fail with "web page, not a video file"? The server answered with an HTML page (a player page, a login page or an error). Open the link in a browser: it should start downloading or playing the raw file.

Which video formats work? MP4/MOV/M4V, WebM/MKV, AVI, FLV, MPEG-TS/PS, Ogg, ASF/WMV and GIF containers, with the codecs ffmpeg can decode (for example H.264, H.265 and VP9).

Are rotated phone videos handled? Yes, frames come out upright and with square pixels.

Do I get the whole video as images? Only as many frames as you ask for. Use a small interval and a high maxFramesPerVideo for dense sampling.

What are the sample videos? The default input uses two short public clips so the Actor works out of the box. The first is a Big Buck Bunny clip, (c) copyright 2008 Blender Foundation, www.bigbuckbunny.org, licensed CC BY 3.0, as hosted by w3schools.com; the frames you get from it are cut-outs of that clip and keep that license and credit. The second is the "flower" clip from the MDN Web Docs sample media, released under CC0 (public domain). Replace both with your own links.

Support

Questions or a video type that does not work? Open an issue on the Actor page and include the run link. Built by Atesen Software.