# Vimeo Downloader & Scraper - HD/4K MP4 + Metadata (`dltik/vimeo-scraper`) Actor

Get direct Vimeo download links (MP4 SD/HD/4K) plus full metadata: title, duration, views, likes, formats, uploader, privacy. Single videos, showcases, channels, groups and batch URLs. Optional password for private videos. Export to Excel/CSV/JSON.

- **URL**: https://apify.com/dltik/vimeo-scraper.md
- **Developed by:** [Walid](https://apify.com/dltik) (community)
- **Categories:** Videos, Developer tools, Automation
- **Features:** Limited permissions
- **Stats:** 104 total users, 12 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 video scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## Vimeo Downloader & Scraper — Download HD/4K MP4 + Metadata

> **Download Vimeo videos in HD and 4K** and extract full metadata in one run. Get direct **MP4 download links** per quality (SD / HD / 4K), plus title, duration, views, likes, uploader, formats and privacy status. Works on single videos, showcases, channels, groups and batch URL lists. **Optional password support** for private videos. Export to **Excel, CSV or JSON**. HTTP-only, **$0.002 per video**.

⭐ **Bookmark this Vimeo Downloader** — Apify ranks actors by bookmarks, so it directly helps the visibility of this scraper on the Apify Store.

### What is the Vimeo Downloader & Scraper?

The **Vimeo Downloader & Scraper** is an Apify actor that resolves the direct **MP4 download URLs** for any [Vimeo](https://vimeo.com/) video and returns them alongside clean metadata. Drop in a list of URLs and get back a dataset with: per-quality download links (`download_url`, `download_hd`, `download_4k`, plus a full `download_formats` list), title, duration, view count, likes, available qualities (MP4 SD/HD/4K), uploader, upload date, privacy status (public/unlisted/password-protected), description and tags. Password-protected videos are supported via the `videoPassword` field.

It powers two jobs at once: **save Vimeo videos** (grab the highest-quality direct MP4) and **research Vimeo at scale** (bulk metadata for analytics).

#### Ready-made tasks — run in one click

| Task | What it does |
|------|--------------|
| [Download Vimeo in HD](https://apify.com/dltik/vimeo-scraper/download-vimeo-hd) | Direct HD MP4 link for a single video |
| [Vimeo to MP4](https://apify.com/dltik/vimeo-scraper/vimeo-to-mp4) | Convert & save a Vimeo video as MP4 |
| [Save Vimeo Video (bulk)](https://apify.com/dltik/vimeo-scraper/save-vimeo-video) | Download links for a whole channel/showcase |
| [Download Vimeo in 4K](https://apify.com/dltik/vimeo-scraper/download-vimeo-4k) | Direct 2160p MP4 link when available |
| [Export Vimeo to Excel](https://apify.com/dltik/vimeo-scraper/export-vimeo-to-excel) | Links + metadata, ready for XLSX/CSV export |

### How to download a Vimeo video in HD

1. **[Create a free Apify account](https://apify.com/sign-up)** — no credit card required.
2. Open the actor, paste a Vimeo URL (e.g. `https://vimeo.com/347119375`).
3. Click **Start**. The run returns `download_hd` — a direct MP4 link at the best 720p–1080p rendition.
4. Click the link in the output to **save the Vimeo video** to your machine.

```json
{ "url": "https://vimeo.com/347119375" }
```

> ℹ️ Vimeo download URLs are signed and **time-limited** — re-run the actor to refresh an expired link.

### How to download Vimeo in 4K

If the source video was uploaded in 4K, the `download_4k` field holds a direct **2160p MP4** link (and `qualities_available` lists every quality the actor resolved). For sources without a 4K rendition, `download_4k` is `null` and `download_url` falls back to the highest available quality.

```json
{
  "urls": [
    "https://vimeo.com/123456789",
    "https://vimeo.com/987654321"
  ]
}
```

### How to convert / save Vimeo to MP4

Every direct link the actor returns is already an **MP4** file — no conversion step needed. The `download_formats` array lists every rendition with `quality`, `height`, `ext`, `filesize` and a `direct` flag (true = single-file MP4 you can open or save in one request; false = DASH/HLS stream that needs merging). Filter on `direct: true` to get clean save-ready MP4 links.

### How to export Vimeo data to Excel

After any run, open the dataset and use Apify's built-in **Export** button to download your results as **Excel (XLSX), CSV or JSON**. Each row includes the download links and metadata, so you can keep a spreadsheet of Vimeo videos with direct MP4 URLs, views, duration and uploader — ideal for content audits and client deliverables.

### Use cases

- **Save / archive Vimeo videos** — pull the best-quality direct MP4 for offline backup or client deliverables.
- **Bulk Vimeo download** — feed a channel or showcase URL, get download links for every video.
- **Creative-industry analytics** — track top Vimeo creators in design, animation and photography.
- **Agency portfolio monitoring** — bulk-pull metadata + download links from agency Vimeo channels.
- **Format tracking** — see which creators publish in 4K / HDR via `qualities_available`.
- **Multi-platform creator analytics** — combine Vimeo with YouTube/Dailymotion data for a full view.

### Input

```json
{
  "url": "https://vimeo.com/347119375",
  "urls": [
    "https://vimeo.com/123456789",
    "https://vimeo.com/showcase/example",
    "https://vimeo.com/channels/staffpicks"
  ],
  "videoPassword": "optional_password_for_private_videos",
  "maxResults": 50
}
```

| Field | Type | Description |
|-------|------|-------------|
| `url` | string | A single Vimeo video, showcase, channel or group URL. |
| `urls` | array | List of Vimeo URLs for batch processing. |
| `videoPassword` | string (secret) | Password for private/protected Vimeo videos. |
| `maxResults` | integer | Max videos to return (1–1000, default 50). |

### Output

```json
{
  "id": "347119375",
  "url": "https://vimeo.com/347119375",
  "title": "Example creative film",
  "duration": 247,
  "view_count": 12453,
  "like_count": 423,
  "uploader": "example_creator",
  "uploader_url": "https://vimeo.com/example_creator",
  "upload_date": "20260322",
  "privacy": "public",
  "qualities_available": ["sd", "720p", "1080p", "4k"],
  "download_url": "https://player.vimeo.com/progressive_redirect/playback/...",
  "download_hd": "https://player.vimeo.com/progressive_redirect/playback/...",
  "download_4k": "https://player.vimeo.com/progressive_redirect/playback/...",
  "download_formats": [
    { "quality": "1080p", "height": 1080, "ext": "mp4", "filesize": 41200000, "direct": true, "download_url": "https://..." },
    { "quality": "720p",  "height": 720,  "ext": "mp4", "filesize": 13200000, "direct": true, "download_url": "https://..." }
  ],
  "thumbnail": "https://i.vimeocdn.com/...",
  "tags": ["short film", "animation"]
}
```

### Pricing

**PAY_PER_EVENT — $0.002 per video** (= $2 per 1,000). Failed fetches are not charged.

| Videos | Cost |
|--------|------|
| 1 video | $0.002 |
| 100 videos | $0.20 |
| 1,000 videos | $2.00 |

### FAQ

**Does it actually download the MP4 file?** It returns the **direct MP4 download URL** for each quality. Click the link (or pipe it to your downloader / `curl`) to save the file. This keeps the actor fast and cheap — you only fetch the bytes you actually want.

**Why is a download link expired?** Vimeo signs progressive URLs with a short TTL. Re-run the actor to get fresh links.

**Why is `download_4k` null?** That source video has no 4K rendition. `qualities_available` always shows what Vimeo actually serves for that video.

**Password-protected videos?** Yes — pass the password via the `videoPassword` field.

**Showcase / channel / group expansion?** Yes — those URLs are auto-expanded into their constituent videos.

**Vimeo official API alternative?** Vimeo's API is gated (Pro account + app approval). This actor needs no auth and no quota for public videos.

***

⭐ **Found this useful? Bookmark this Vimeo Downloader** — it's the strongest single signal for Apify Store ranking.

#### Related actors

- [Dailymotion Scraper](https://apify.com/dltik/dailymotion-scraper) — same download + metadata pattern for Dailymotion
- [YouTube Transcript Scraper](https://apify.com/dltik/youtube-transcript-scraper) — bulk YouTube transcripts
- [SoundCloud Scraper](https://apify.com/dltik/soundcloud-scraper) — audio metadata + download
- [Rumble Scraper](https://apify.com/dltik/rumble-scraper) — video metadata + dislikes
- [Bilibili Scraper](https://apify.com/dltik/bilibili-scraper) — Chinese video platform

License: MIT · Author: [dltik](https://apify.com/dltik)

# Actor input Schema

## `url` (type: `string`):

URL d'une vidéo, showcase, channel ou groupe Vimeo (ex: https://vimeo.com/347119375)

## `urls` (type: `array`):

Liste d'URLs Vimeo pour traitement batch

## `videoPassword` (type: `string`):

Mot de passe pour accéder aux vidéos Vimeo protégées par mot de passe

## `maxResults` (type: `integer`):

Nombre maximum de vidéos à retourner (1-1000)

## Actor input object example

```json
{
  "url": "https://vimeo.com/347119375",
  "maxResults": 50
}
```

# Actor output Schema

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

Métadonnées structurées de chaque vidéo Vimeo : titre, durée, vues, likes, privacy, formats disponibles, uploader.

# 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 = {
    "url": "https://vimeo.com/347119375"
};

// Run the Actor and wait for it to finish
const run = await client.actor("dltik/vimeo-scraper").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 = { "url": "https://vimeo.com/347119375" }

# Run the Actor and wait for it to finish
run = client.actor("dltik/vimeo-scraper").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 '{
  "url": "https://vimeo.com/347119375"
}' |
apify call dltik/vimeo-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dltik/vimeo-scraper"
        }
    }
}
```

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/mvLHuBVBJRM0DbJeY/builds/KKNWEpfjZyG9oVUHY/openapi.json