# Video Frame Extractor: MP4, TikTok, Instagram Reels to Images (`themineworks/video-frame-extractor`) Actor

Extract still frames from MP4, WebM and MOV links, TikTok videos and Instagram reels: every N seconds, N evenly spaced, at the times you list or at each scene change. One row per frame with its image link, timestamp, width and height. Max resolution, blank frame skip. No login.

- **URL**: https://apify.com/themineworks/video-frame-extractor.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Videos, AI, Automation
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 frames

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Video Frame Extractor: MP4, TikTok, Instagram Reels to Images

[![11 frames from a video link, one row per frame with its image link, in 4 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/video-frame-extractor-hero.png)](https://console.apify.com/actors/p5eVvRNhcrsyGArC4/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

From **The Mine Works**, makers of [Instagram Reel Scraper](https://apify.com/themineworks/instagram-reel-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), with over 290,000 runs across 310+ public actors.

Updated 30 Oct 2026: first release. Direct MP4, WebM, MOV and MKV links, TikTok videos and Instagram reels; a frame every N seconds, N frames spread evenly, the exact times you list, or one per scene change; max resolution, JPG, PNG or WebP, blank frames stepped past. One row per frame with its image link. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **TikTok and Instagram links work as they are.** Paste a TikTok video link or an Instagram reel link next to your MP4 links. The actor finds the video file behind the post and downloads the smallest copy that reaches the size you asked for, so a 720 px frame from a reel does not pay for a 1080p download. In our test, 40 of 40 TikTok and Instagram links from four public profiles returned frames.
- **Long files cost only the parts you use.** For interval, count and timestamps modes the actor reads only the stretches of the file around each frame. 10 frames of a 296 MB, 15 minute film read 24 MB in our test, not the whole file.
- **One row per frame, ready for a spreadsheet or an AI model.** Every row has the image link, `timestamp_sec` and `timestamp` (00:01:23.500), `frame_index`, `width` and `height`, plus the video's length, size and codec. The links open without an Apify login, so you can pass them straight to GPT, Claude or Gemini.
- **No black frames by default, and you do not pay for them.** A frame that is one flat colour (a fade from black, a cut to black) is swapped for the first frame with content up to 2 seconds later; if there is none, it is dropped and not charged. Links that cannot be read, the summary row and duplicates are never charged.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/p5eVvRNhcrsyGArC4/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Social media and video family:** [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns one frame every 5 seconds from the 52 second Sintel trailer, 11 frames in all. It took 4 seconds in our test run, plus the few seconds Apify needs to start the run. The first frame of this trailer is black, so it comes from 2 seconds in and says so in `stepped_from_sec`:

```json
{
  "videoUrls": ["https://media.w3.org/2010/05/sintel/trailer.mp4"],
  "mode": "interval",
  "intervalSeconds": 5
}
```

Add more links on separate lines, mix MP4 files, TikTok videos and Instagram reels, and pick another mode below. Every frame is a row; open `image_url` to see it.

Apify's free plan includes $5 of credit every month, which covers about 2,500 frames at this actor's price.

#### Copy to your AI assistant

```text
themineworks/video-frame-extractor on Apify. Turns video links into still images: direct video files (MP4, WebM, MOV, MKV, M4V), TikTok video links and Instagram reel or video post links, with no login. Returns one dataset row per frame with a public image link. Call ApifyClient("TOKEN").actor("themineworks/video-frame-extractor").call(run_input={"videoUrls": ["https://media.w3.org/2010/05/sintel/trailer.mp4"], "mode": "interval", "intervalSeconds": 5}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give videoUrls (list of links, up to 200 per run; YouTube is not supported). Optional: mode (interval, count, timestamps or scenes; default interval), intervalSeconds (default 5), frameCount (count mode, default 10), timestamps (list such as "90", "1:30", "00:02:15.5", "1m30s"), sceneThreshold (scenes mode, default 0.3, lower finds more cuts), startTime and endTime (same time formats), maxFramesPerVideo (default 50, up to 1000), maxResolution (longest side in px, default 1280, 0 keeps the original), imageFormat (jpg, png or webp; default jpg), skipBlankFrames (default true; steps past one colour frames up to 2 s, not in timestamps mode), maxDownloadMbPerVideo (default 500). Frame rows have no _type field and carry video_url, page_url, platform, video_id, frame_index, timestamp_sec, timestamp, mode, scene_score, stepped_from_sec, image_url, image_key, image_format, width, height, image_bytes, video_duration_sec, video_width, video_height, video_codec, video_fps, video_title, author_username, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when frames were delivered, and a row with _type "error" for each link that could not be read; none of these is charged. The images are records of the run's default key-value store (image_key). Full spec: GET https://api.apify.com/v2/acts/themineworks~video-frame-extractor/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **Four ways to pick frames.** `interval`: one frame every N seconds (0.5 gives two a second). `count`: N frames, each from the middle of an equal slice of the video. `timestamps`: the exact times you list, in seconds, clock time or 1m30s. `scenes`: the opening shot plus one frame at each cut, with a sensitivity you can set; over the cap, the strongest cuts are kept.
- **Start and end time.** Limit any mode except timestamps to a part of the video, for example the first minute of a webinar or 5:00 to 10:00 of a match.
- **Max resolution on the longest side.** 1280 gives 1280x720 from a landscape video and 720x1280 from a vertical TikTok. Frames are never enlarged; 0 keeps the original size. Phone videos are turned the right way up.
- **The right copy of a TikTok or reel.** TikTok lists each video in several sizes and codecs, Instagram in several quality tiers up to 1080p. The actor takes the smallest one that reaches your max resolution, and the full 1080p copy when you ask for the original.
- **Accurate times.** Each frame is cut at the time asked, not at the nearest keyframe. In scenes mode `scene_score` says how strong each cut was, from 0 to 1.
- **Safe on big and odd files.** A per video download limit, hosts that do not allow partial reads (read once, front to back), links that open a web page instead of a file, and dead links each get a plain reason in an error row, and are not charged. A dead link costs one request; two videos in a row that a site refuses end the run, so a blocked run takes seconds.

### How to use it

#### Thumbnails or a storyboard for each video

```json
{
  "videoUrls": [
    "https://media.w3.org/2010/05/sintel/trailer.mp4",
    "https://media.w3.org/2010/05/bunny/trailer.mp4"
  ],
  "mode": "count",
  "frameCount": 8,
  "maxResolution": 640
}
```

Eight evenly spaced frames per video at 640 px. Good for a preview strip, a course catalogue or a quick look at many files.

#### TikTok and Instagram reels for an AI model

```json
{
  "videoUrls": [
    "https://www.tiktok.com/@nasa/video/7700397098994273549",
    "https://www.instagram.com/reel/Dd9Etk7R91I/"
  ],
  "mode": "interval",
  "intervalSeconds": 2,
  "maxResolution": 768
}
```

A frame every 2 seconds is enough for a vision model to describe, tag or moderate a short video. Pass the `image_url` links to the model in the order of `frame_index`; `video_title` and `author_username` give it the post's caption and creator.

#### One frame per scene of an ad or a trailer

```json
{
  "videoUrls": ["https://download.blender.org/durian/trailer/sintel_trailer-1080p.mp4"],
  "mode": "scenes",
  "sceneThreshold": 0.3
}
```

In our test this returned 7 frames for the 52 second Sintel trailer: the opening shot and 6 cuts, each with its `scene_score`. Lower the threshold to 0.2 to catch soft cuts and dissolves.

#### Exact moments you already know

```json
{
  "videoUrls": ["https://archive.org/download/Sintel/sintel-2048-surround.mp4"],
  "mode": "timestamps",
  "timestamps": ["0:45", "3:12.5", "7m30s", "12:00"]
}
```

Times past the end of a video are skipped and not charged. In timestamps mode the frames are always at the exact times you gave, blank or not.

#### A long recording, one frame a minute

```json
{
  "videoUrls": ["https://archive.org/download/Sintel/sintel-2048-surround.mp4"],
  "mode": "interval",
  "intervalSeconds": 60,
  "maxResolution": 1280
}
```

The actor reads only the parts of the file around each frame, so a long file is fast and light. Use `startTime` and `endTime` to cover part of it.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `videoUrls` | array of strings | required | Direct video file links, TikTok video links, Instagram reel or video post links. Up to 200 per run. |
| `mode` | string | `interval` | `interval`, `count`, `timestamps` or `scenes`. |
| `intervalSeconds` | number | `5` | Interval mode: seconds between frames, 0.1 to 3,600. |
| `frameCount` | integer | `10` | Count mode: frames per video, spread evenly. |
| `timestamps` | array of strings | empty | Timestamps mode: `90`, `90.5`, `1:30`, `00:01:30.250` or `1m30s`. |
| `sceneThreshold` | number | `0.3` | Scenes mode: 0.05 to 0.95, lower finds more cuts. |
| `startTime`, `endTime` | string | empty | Part of the video to use, same time formats. Not used in timestamps mode. |
| `maxFramesPerVideo` | integer | `50` | Most frames per video, 1 to 1,000. |
| `maxResolution` | integer | `1280` | Longest side of each image in pixels; `0` keeps the original size. |
| `imageFormat` | string | `jpg` | `jpg`, `png` or `webp`. |
| `skipBlankFrames` | boolean | `true` | Step past one colour frames up to 2 s; drop and do not charge them if nothing shows. |
| `maxDownloadMbPerVideo` | integer | `500` | Most video data read for one video, in MB. |

### What data do you get?

One row per frame. Frame rows have no `_type` field; the summary, info and error rows do, so a filter on `_type` separates them.

| Field | What it is |
|---|---|
| `video_url` | The link as you gave it |
| `page_url` | The TikTok or Instagram page of the video (platform links) |
| `platform` | `direct`, `tiktok` or `instagram` |
| `video_id` | TikTok video id or Instagram shortcode |
| `frame_index` | Position of the frame in its video, from 1 |
| `timestamp_sec`, `timestamp` | Where the frame is, in seconds and as `HH:MM:SS.mmm` |
| `mode` | How the frame was chosen |
| `scene_score` | Scenes mode: strength of the cut, 0 to 1 (empty for the opening shot) |
| `stepped_from_sec` | Set when a blank frame was swapped for a later one: the time first planned |
| `image_url` | Link to the image |
| `image_key` | The image's key in the run's key-value store |
| `image_format`, `width`, `height`, `image_bytes` | The image file |
| `video_duration_sec`, `video_width`, `video_height`, `video_codec`, `video_fps` | The video file that was read |
| `video_title` | TikTok description, Instagram caption or the file name |
| `author_username` | TikTok or Instagram username |
| `scraped_at` | When the frame was cut |

**Summary row** (`_type: "summary"`, never charged): `videos_requested`, `videos_read`, `videos_failed`, `frames_planned`, `frames_delivered`, `charged_for`, `frames_past_end`, `frames_over_cap`, `blank_frames_stepped`, `blank_frames_skipped`, `scene_cuts_found`, `downloaded_megabytes`, `ended_on_deadline`, `stopped_by_max_cost`, `shortfall_reason` when fewer frames came back than planned, and `per_video`, one entry per video with its status, frames, size, MB downloaded and the reason when it failed. The same summary is saved as the `OUTPUT` record of the run.

**Error rows** (`_type: "error"`, never charged): one per link that could not be read, with `error_type` (`invalid_url`, `youtube_not_supported`, `not_a_video_file`, `not_a_video`, `not_found`, `refused`, `rate_limited`, `too_large`, `unreadable`, `no_frames`, `blocked`, `fetch_error`), `identifier`, `reason` and `http_status` when the host answered.

#### Stable fields for automations

These were present in every frame row of our test runs, and their names will not change:

| Field | What it is |
|---|---|
| `video_url` | The link you gave |
| `platform` | Where the video came from |
| `frame_index` | Order of the frame |
| `timestamp_sec` | Time in seconds |
| `timestamp` | Time as text |
| `image_url` | The image |
| `image_key` | The image record |
| `width`, `height` | Image size |
| `image_bytes` | Image file size |
| `video_duration_sec` | Video length |
| `video_codec` | Codec of the file read |

Optional: `page_url`, `video_id` and `author_username` (TikTok and Instagram only), `scene_score` (scenes mode), `stepped_from_sec` (only on frames that were moved past a blank frame), `video_fps` (when the file states it).

#### Output examples

A frame from a TikTok video, a frame every 3 seconds at 1280 px (test run, 30 Oct 2026; on Apify `image_url` carries the real store id and a signature):

```json
{
  "video_url": "https://www.tiktok.com/@nasa/video/7700397098994273549",
  "page_url": "https://www.tiktok.com/@nasa/video/7700397098994273549",
  "platform": "tiktok",
  "video_id": "7700397098994273549",
  "frame_index": 2,
  "timestamp_sec": 3,
  "timestamp": "00:00:03.000",
  "mode": "interval",
  "image_url": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/7700397098994273549-408bde-0002-00003000ms.jpg",
  "image_key": "7700397098994273549-408bde-0002-00003000ms.jpg",
  "image_format": "jpg",
  "width": 720,
  "height": 1280,
  "image_bytes": 150829,
  "video_duration_sec": 16.903,
  "video_width": 720,
  "video_height": 1280,
  "video_codec": "hevc",
  "video_fps": 30,
  "video_title": "NASA 🤝 college football. We heard y’all like a good air show. Roll Tide!",
  "author_username": "nasa"
}
```

A frame from an Instagram reel in the same run (caption trimmed):

```json
{
  "video_url": "https://www.instagram.com/reel/DfHwGxbBD_K/",
  "platform": "instagram",
  "video_id": "DfHwGxbBD_K",
  "frame_index": 2,
  "timestamp_sec": 3,
  "timestamp": "00:00:03.000",
  "image_key": "DfHwGxbBD_K-4db3ae-0002-00003000ms.jpg",
  "width": 720,
  "height": 1280,
  "image_bytes": 53842,
  "video_duration_sec": 26.86,
  "video_codec": "vp9",
  "video_title": "To capture Jim Morrison's incredible accomplishment, the team was willing to go beyond ...",
  "author_username": "natgeo"
}
```

A scene frame from the Sintel 1080p trailer, moved half a second past a cut to black (same day):

```json
{
  "video_url": "https://download.blender.org/durian/trailer/sintel_trailer-1080p.mp4",
  "platform": "direct",
  "frame_index": 7,
  "timestamp_sec": 28.5,
  "timestamp": "00:00:28.500",
  "mode": "scenes",
  "scene_score": 0.6823,
  "stepped_from_sec": 28,
  "image_key": "sintel_trailer-1080p.mp4-fd7bd5-0007-00028500ms.jpg",
  "width": 640,
  "height": 360,
  "video_duration_sec": 52.208,
  "video_width": 1920,
  "video_height": 1080,
  "video_codec": "h264",
  "video_fps": 24
}
```

An error row for a YouTube link (nothing charged):

```json
{ "_type": "error", "error_type": "youtube_not_supported", "identifier": "https://www.youtube.com/watch?v=aqz-KE-bpKQ", "reason": "YouTube links are not supported yet. Use a direct link to the video file, a TikTok video or an Instagram reel. Not charged." }
```

### Pricing

Pay per event: you pay for the frames you receive, plus a flat $0.003 per run, whatever memory you choose. Scene detection, max resolution, blank frame checks and the platform lookups cost nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `frame-extracted` | Once per frame row stored in your dataset | $1.80 per 1,000 | $1.70 per 1,000 | $1.55 per 1,000 | $1.40 per 1,000 |
| `run-start` | Once per run, just before the first frames are delivered | $0.003 | $0.003 | $0.003 | $0.003 |

The price of one frame is the price per 1,000 divided by 1,000.

Never charged:

- links that cannot be read: YouTube, web pages instead of files, dead or private links, photo posts (each gets an error row);
- frames that fail, blank frames that were dropped, and timestamps past the end of a video;
- frames past your `maxFramesPerVideo`;
- a video that a run already read (the same link twice);
- the summary, info and error rows;
- a run in which no frame is delivered: the start fee is charged only right before the first frames are delivered;
- anything past your "Max cost per run". The actor checks the budget before it cuts the frames of each video and cuts only what the budget can pay for, so the run ends SUCCEEDED with a partial result and a status message saying so.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often.
3. For a stream of new videos, start the actor from your own pipeline instead (Make, Zapier, n8n or the API) with the new links each time; a run with one video is fine.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run's frames land where your team works.

### FAQ

#### Which links work?

Direct links to video files: MP4, M4V, MOV, WebM, MKV, MPEG TS and anything else ffmpeg reads, from your own storage (S3, R2, Google Cloud Storage), a CDN or a website. TikTok video links (`tiktok.com/@user/video/...`, `vm.tiktok.com` and `vt.tiktok.com` share links) and Instagram reel or video post links (`instagram.com/reel/...`, `instagram.com/p/...`; each video of a carousel is read). Google Drive and Dropbox share links open a web page: use their download link (Dropbox: add `?dl=1`).

#### Does it work with YouTube?

Not in this version. A YouTube link gets an error row and costs nothing.

#### Do you download the whole video?

Not for long files in interval, count and timestamps modes: the actor reads only the parts around each frame. Files up to 24 MB, hosts that do not allow partial reads, and scene mode read the whole file once. `downloaded_megabytes` in the summary shows what each video took.

#### Why are some frames moved by a second or two?

With `skipBlankFrames` on (the default), a frame that is one flat colour, such as the black at a fade in or a cut, is replaced by the first frame with content up to 2 seconds later, never past the next frame. Those rows carry `stepped_from_sec`. Turn the option off to get every frame at its planned time. Timestamps mode never moves a frame.

#### How many frames can I get?

Up to 1,000 per video and 200 videos per run. `count` never returns more frames than you ask for; `interval` and `timestamps` keep the first `maxFramesPerVideo`; `scenes` keeps the strongest cuts.

#### How long does a run take?

In our tests on a laptop: 4 seconds for the "Try it" input, 3 seconds for scene detection on the 52 second 1080p Sintel trailer, 39 seconds for 10 frames from a 296 MB film on a slow office line, and 325 seconds for 613 frames from 40 TikTok and Instagram videos on the same line. On Apify the default 1 GB of memory comes with a quarter of a CPU, so cutting frames takes longer than on a laptop; give the run more memory for a faster run. Compute is billed on memory times time, so a faster run costs about the same. The default time limit is 3,600 seconds; the actor stops before it and keeps every frame.

#### How long do the image links last?

The images are records of the run's default key-value store and are kept as long as Apify keeps that run's storage (see your plan's data retention). Download them, or copy them to your own storage, if you need them for longer.

#### Do I need an account, cookies or a proxy?

No. TikTok and Instagram links are read over Apify Proxy, which is included. Direct links are read straight from their host.

#### Which formats can I download?

Rows as JSON, CSV, Excel, XML, RSS or HTML from the run's Storage tab or the API. The images are JPG, PNG or WebP files in the run's key-value store; the dataset's Frames view shows each one in the table.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/video-frame-extractor

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http video-frame-extractor "https://mcp.apify.com/?tools=themineworks/video-frame-extractor"`

#### Is it legal to extract frames from these videos?

The actor reads only public videos, as anyone can see them without logging in. You are responsible for having the right to process each video you submit, including the terms of TikTok and Instagram, copyright and data protection law such as GDPR and CCPA. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's rows to a sheet; `image_url` shows as a link per frame.
- **Make, Zapier and n8n**: start a run with new video links and read its dataset, for example "frames of each new upload to our moderation queue".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the rows and images.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

### More from The Mine Works

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Twitter / X Scraper](https://apify.com/themineworks/twitter-x-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [YouTube Transcript](https://apify.com/themineworks/youtube-transcript-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Xiaohongshu (RED) Scraper](https://apify.com/themineworks/xiaohongshu-explore-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Scraper](https://apify.com/themineworks/telegram-channel-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Finder](https://apify.com/themineworks/telegram-channel-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Pinterest Profile Scraper](https://apify.com/themineworks/pinterest-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a link that should work and does not, or a frame at the wrong time? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a mode or a source you need, email dmineworks@gmail.com.

*Paste MP4 links, TikTok videos or Instagram reels and get still frames back as JPG, PNG or WebP, every N seconds, at set times or at each scene change, one row per frame with its image link, no login.*

# Actor input Schema

## `videoUrls` (type: `array`):

One link per line: a direct link to a video file (.mp4, .webm, .mov, .mkv, .m4v), a TikTok video (https://www.tiktok.com/@user/video/123... or a vm.tiktok.com share link) or an Instagram reel or video post (https://www.instagram.com/reel/CODE/). Up to 200 videos per run. YouTube links are not supported yet.

## `mode` (type: `string`):

interval: one frame every N seconds. count: N frames spread evenly over the video. timestamps: the exact times you list. scenes: one frame per scene change (the opening shot plus each cut).

## `intervalSeconds` (type: `number`):

Interval mode: one frame every this many seconds, starting at the start time. 0.5 gives two frames a second. Example: 5.

## `frameCount` (type: `integer`):

Count mode: how many frames to take. Each comes from the middle of an equal slice of the video, which avoids the black first and last frames. Example: 10.

## `timestamps` (type: `array`):

Timestamps mode: the times to capture, one per line. Seconds (90 or 90.5), clock time (1:30 or 00:01:30.250) or 1m30s. Times past the end of a video are skipped and not charged.

## `sceneThreshold` (type: `number`):

Scenes mode: how different two frames in a row must be to count as a cut, 0.05 to 0.95. Lower finds more cuts (0.2 catches soft cuts), higher only hard cuts. Default 0.3.

## `startTime` (type: `string`):

Ignore everything before this time, for example 30, 0:30 or 1m. Applies to interval, count and scenes.

## `endTime` (type: `string`):

Ignore everything after this time, for example 300, 5:00 or 5m. Leave empty to run to the end.

## `maxFramesPerVideo` (type: `integer`):

Upper limit on frames for each video, 1 to 1,000. Interval and timestamps keep the first ones; scenes keeps the strongest cuts. You pay only for frames delivered.

## `maxResolution` (type: `integer`):

Frames are scaled down so their longest side is at most this many pixels, keeping the shape, never enlarged. 1280 gives 1280x720 from a landscape video and 720x1280 from a TikTok. 0 keeps the original size. For TikTok and Instagram the smallest copy of the video that reaches this size is downloaded.

## `imageFormat` (type: `string`):

jpg is small and opens everywhere, png is lossless and larger, webp is small with high quality.

## `skipBlankFrames` (type: `boolean`):

On: a frame that is one flat colour (black at a fade in or a cut, white, a single colour card) is replaced by the first frame with content up to 2 seconds later, never past the next frame; if there is none it is dropped and not charged. Title cards (text on black) are kept. Timestamps mode always keeps the exact times. Each moved frame says where it was planned in stepped_from_sec.

## `maxDownloadMbPerVideo` (type: `integer`):

Safety limit on video data read for one video. Interval, count and timestamps read only the parts of a large file they need (10 frames of a 300 MB film read about 24 MB); scenes mode reads the whole file. Default 500.

## Actor input object example

```json
{
  "videoUrls": [
    "https://media.w3.org/2010/05/sintel/trailer.mp4"
  ],
  "mode": "interval",
  "intervalSeconds": 5,
  "frameCount": 10,
  "sceneThreshold": 0.3,
  "maxFramesPerVideo": 50,
  "maxResolution": 1280,
  "imageFormat": "jpg",
  "skipBlankFrames": true,
  "maxDownloadMbPerVideo": 500
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `images` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "videoUrls": [
        "https://media.w3.org/2010/05/sintel/trailer.mp4"
    ],
    "mode": "interval",
    "intervalSeconds": 5,
    "maxFramesPerVideo": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/video-frame-extractor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "videoUrls": ["https://media.w3.org/2010/05/sintel/trailer.mp4"],
    "mode": "interval",
    "intervalSeconds": 5,
    "maxFramesPerVideo": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/video-frame-extractor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "videoUrls": [
    "https://media.w3.org/2010/05/sintel/trailer.mp4"
  ],
  "mode": "interval",
  "intervalSeconds": 5,
  "maxFramesPerVideo": 50
}' |
apify call themineworks/video-frame-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/video-frame-extractor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/p5eVvRNhcrsyGArC4/builds/dwT86x2uEf2HCclj0/openapi.json
