Vimeo Scraper

Scrape public videos from Vimeo channels, user profiles, specific video IDs, and the Staff Picks channel. Extract video titles, descriptions, stats, thumbnails, tags, and more — no API key required.

What Does Vimeo Scraper Do?

This actor lets you:

• Scrape channel videos — get all public videos from any Vimeo channel by slug
• Scrape user videos — download the public video catalogue of any Vimeo creator
• Fetch video details — retrieve full metadata for specific video URLs or IDs
• Browse Staff Picks — scrape Vimeo's curated Staff Picks channel

Input

Field	Type	Description
mode	String	Scraping mode: byChannel, byUser, videoDetails, staffPicks
channelSlugs	Array	Channel slugs or URLs (e.g. staffpicks, animation)
usernames	Array	Vimeo usernames or numeric user IDs (e.g. nationalgeographic, user170240499)
videoUrls	Array	Vimeo video URLs or numeric IDs (e.g. https://vimeo.com/76979871)
maxItems	Integer	Maximum number of videos to scrape (1–2000, default: 20)

Example Inputs

Scrape a channel:

{
  "mode": "byChannel",
  "channelSlugs": ["staffpicks", "animation"],
  "maxItems": 50
}

Scrape a user's videos:

{
  "mode": "byUser",
  "usernames": ["nationalgeographic"],
  "maxItems": 30
}

Fetch specific videos:

{
  "mode": "videoDetails",
  "videoUrls": ["https://vimeo.com/22439234", "https://vimeo.com/76979871"],
  "maxItems": 10
}

Staff Picks:

{
  "mode": "staffPicks",
  "maxItems": 50
}

Output

Each record contains the following fields (nulls and empty values are omitted):

Field	Type	Description
videoId	String	Vimeo video ID
title	String	Video title
url	String	Video page URL
thumbnailUrl	String	Largest available thumbnail URL
description	String	Plain-text description (HTML stripped)
uploaderId	String	Uploader's numeric Vimeo user ID
uploaderName	String	Uploader display name
uploaderUrl	String	Uploader profile URL
uploaderAvatarUrl	String	Uploader avatar image URL
publishedAt	String	Upload date in ISO 8601 format
duration	Integer	Video duration in seconds
likeCount	Integer	Number of likes
viewCount	Integer	Number of plays/views
commentCount	Integer	Number of comments
width	Integer	Video width in pixels
height	Integer	Video height in pixels
isHD	Boolean	Whether the video is HD (720p or higher)
tags	Array	List of tag strings
privacy	String	Embed privacy: public or unlisted
embedUrl	String	Vimeo player embed URL
channelName	String	Channel display name (channel mode only)
channelTotalVideos	Integer	Total videos published in the channel (channel mode only)
channelTotalSubscribers	Integer	Total subscriber count of the channel (channel mode only)
sourceUrl	String	URL used to discover this video
scrapedAt	String	ISO 8601 timestamp of when the record was scraped
recordType	String	Always video

Example Output Record

{
  "videoId": "22439234",
  "title": "The Mountain",
  "url": "https://vimeo.com/22439234",
  "thumbnailUrl": "https://i.vimeocdn.com/video/145027281-cf3e3e047a52e2210b26bbcf42fcde909a80a7dd023a757b95af01936d065ec0-d_640?region=us",
  "description": "A time-lapse of the Milky Way over El Teide, Spain's highest mountain.",
  "uploaderName": "TSO Photography",
  "uploaderUrl": "https://vimeo.com/terjes",
  "publishedAt": "2011-04-15T08:35:35Z",
  "duration": 185,
  "likeCount": 104319,
  "viewCount": 78950639,
  "commentCount": 2809,
  "width": 1920,
  "height": 1080,
  "isHD": true,
  "tags": ["mountain", "timelapse", "stars", "milkyway", "spain"],
  "privacy": "public",
  "embedUrl": "https://player.vimeo.com/video/22439234",
  "sourceUrl": "https://vimeo.com/22439234",
  "scrapedAt": "2026-06-30T12:00:00.000000+00:00",
  "recordType": "video"
}

Scraping Modes

byChannel

Scrapes all public videos from one or more Vimeo channels. Provide channel slugs (the part after /channels/ in the URL) or full channel URLs.

Examples: staffpicks, animation, https://vimeo.com/channels/documentary

byUser

Scrapes all public videos uploaded by a Vimeo user. Accepts usernames (e.g. nationalgeographic) or numeric user IDs in user{id} format (e.g. user170240499).

videoDetails

Fetches full metadata for specific videos. Accepts Vimeo video URLs or plain numeric IDs.

Examples: https://vimeo.com/76979871, 76979871

staffPicks

Scrapes Vimeo's curated Staff Picks channel — the best videos handpicked by the Vimeo team.

Frequently Asked Questions

Do I need a Vimeo account or API key? No. This actor uses the public Vimeo API v2 which does not require authentication.

Are private videos included? No. Only publicly accessible videos are scraped. Password-protected or private videos return 404 and are skipped.

Why are some usernames returning no results? Some Vimeo usernames don't match API paths correctly. If a username returns no results, try using the numeric user ID format: user170240499. You can find the numeric ID in the Vimeo profile URL.

How many videos can I scrape? Up to 2000 videos per run with maxItems. Each channel or user is paginated in batches of 20.

Can I scrape multiple channels or users in one run? Yes — pass multiple values in channelSlugs or usernames arrays. The maxItems limit applies per channel/user.

What is the staffPicks mode? It's a shortcut for scraping the Vimeo Staff Picks channel (vimeo.com/channels/staffpicks), which showcases editor-curated videos.

Data Source

Data is fetched from the Vimeo public API v2 (vimeo.com/api/v2). No proxy or authentication is required. The actor respects rate limits with a 0.5-second delay between paginated requests.