# Vimeo Downloader — HD MP4 Video & Metadata Extractor (`dltik/vimeo-scraper`) Actor

Download Vimeo videos in HD/4K MP4, extract metadata, thumbnails and embed info. Get video title, duration, view count, likes, uploader details, privacy settings and direct download URLs. Supports single videos, channels, showcases and albums. No login required. Export JSON, CSV or Excel via API.

- **URL**: https://apify.com/dltik/vimeo-scraper.md
- **Developed by:** [Walid](https://apify.com/dltik) (community)
- **Categories:** Videos, Developer tools, Automation
- **Stats:** 24 total users, 10 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Vimeo Scraper — Video Metadata Extractor (Views, Duration, Privacy)

> Extract **Vimeo video metadata** in bulk: title, duration, views, likes, formats, uploader, privacy status. Supports single videos, showcases, channels, groups, and batch URL input. **Optional password support** for private videos. No video download — clean structured metadata only. HTTP-only, **$0.002 per video**.

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

### What is the Vimeo Scraper?

The **Vimeo Scraper** is an Apify actor that pulls metadata from any [Vimeo](https://vimeo.com/) video, showcase, channel, or group page. Drop in a list of URLs and get back a clean dataset: title, duration, view count, likes count, available formats (MP4 SD/HD/4K), uploader, upload date, privacy status (public/unlisted/password-protected), description, tags. Password-protected videos are supported via the `password` input field.

Useful for creative-industry research, agency portfolios, and tracking premium video content (Vimeo's main differentiator vs YouTube).

### Use cases

- **Creative-industry analytics** — track top Vimeo creators in design, animation, photography categories.
- **Agency portfolio monitoring** — bulk-pull metadata from agency Vimeo channels for competitive intel.
- **Brand-content research** — many brands prefer Vimeo for hero campaigns; track their performance.
- **Multi-platform creator analytics** — combine Vimeo with YouTube/Dailymotion data for full creator view.
- **Archive-building** — full-channel metadata snapshot for client deliverables or research.
- **Format tracking** — see which Vimeo creators use 4K, HDR, etc.

### Input

```json
{
  "urls": [
    "https://vimeo.com/123456789",
    "https://vimeo.com/showcase/example",
    "https://vimeo.com/channels/staffpicks"
  ],
  "passwords": {
    "987654321": "your_password_here"
  }
}
````

### Output

```json
{
  "video_id": "123456789",
  "url": "https://vimeo.com/123456789",
  "title": "Example creative film",
  "description": "Director's cut...",
  "duration_sec": 247,
  "views": 12453,
  "likes": 423,
  "uploader": "example_creator",
  "uploader_url": "https://vimeo.com/example_creator",
  "uploaded_at": "2026-03-22",
  "privacy": "public",
  "formats_available": ["sd", "hd", "4k"],
  "thumbnail": "https://i.vimeocdn.com/...",
  "tags": ["short film", "animation"]
}
```

### Pricing

**PAY\_PER\_EVENT — $0.002 per video metadata fetched** (= $2 per 1,000). Failed fetches not charged.

### FAQ — Vimeo API alternatives

**Vimeo official API alternative?** Vimeo's API is gated (requires Pro account + app approval). This scraper has no auth, no quota for public videos.

**Password-protected videos?** Yes — pass passwords via the `passwords` map keyed by video ID.

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

**Does it download files?** No — metadata only. For download, use yt-dlp (which supports Vimeo).

***

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

#### Related actors

- [Dailymotion Scraper](https://apify.com/dltik/dailymotion-scraper) — same 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

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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=dltik/vimeo-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Vimeo Downloader — HD MP4 Video & Metadata Extractor",
        "description": "Download Vimeo videos in HD/4K MP4, extract metadata, thumbnails and embed info. Get video title, duration, view count, likes, uploader details, privacy settings and direct download URLs. Supports single videos, channels, showcases and albums. No login required. Export JSON, CSV or Excel via API.",
        "version": "1.0",
        "x-build-id": "lViTozrl5Q8L0MoXD"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/dltik~vimeo-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-dltik-vimeo-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/dltik~vimeo-scraper/runs": {
            "post": {
                "operationId": "runs-sync-dltik-vimeo-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/dltik~vimeo-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-dltik-vimeo-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "url": {
                        "title": "URL vidéo",
                        "type": "string",
                        "description": "URL d'une vidéo, showcase, channel ou groupe Vimeo (ex: https://vimeo.com/347119375)"
                    },
                    "urls": {
                        "title": "Liste d'URLs",
                        "type": "array",
                        "description": "Liste d'URLs Vimeo pour traitement batch"
                    },
                    "videoPassword": {
                        "title": "Mot de passe vidéo (optionnel)",
                        "type": "string",
                        "description": "Mot de passe pour accéder aux vidéos Vimeo protégées par mot de passe"
                    },
                    "maxResults": {
                        "title": "Résultats maximum",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Nombre maximum de vidéos à retourner (1-1000)",
                        "default": 50
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
