Vimeo Channel, Creator & Video Metadata Extractor

Scrape Vimeo — public videos, creators, channels, comments and likers. Search by keyword with filters and sort orders, browse categories, tags and showcases, pull a channel or creator's uploads, or look up specific videos by any public URL. No account, API key or proxy setup is needed.

What this actor does

• Twelve modes: byChannel, byUser, videoDetails, staffPicks, search, searchCreators, searchChannels, category, tag, showcase, videoComments and videoLikes
• Search that narrows: duration, 4K, price, Creative Commons license, upload date, Staff Picks, HDR, 360/spatial, live status and category, plus relevance, date, views, likes, comments, duration and alphabetical sorts
• Rich video metadata: views, likes, comments, tags, language, license, content rating, playability, download permission and Staff Pick / HDR / live / VOD badges
• Creator and channel profiles: bios, links, locations, avatars, logos, headers, follower/video counts, tags and categories, emitted before their videos when enabled
• Conversations: comments with authors, dates and reply totals; likers with profile links and join dates
• Empty fields are omitted — a video with no tags simply has no tags field, and zero counts are kept as real data

Output per video

• videoId — numeric Vimeo video ID
• title, description — title and plain-text description
• url, embedUrl — canonical video page and player embed URL
• thumbnailUrl — largest available thumbnail
• uploaderId, uploaderName, uploaderUrl, uploaderAvatarUrl — uploader identity
• publishedAt — upload time in ISO 8601
• releasedAt, updatedAt — release and last-modified times in ISO 8601
• duration — length in seconds
• width, height, isHD — resolution and whether it is 720p or higher
• viewCount — public play count (omitted when the owner hides it)
• likeCount, commentCount — engagement counts, including genuine zeros
• tags[] — tag names, when the uploader set them
• language — language code, when Vimeo reports one
• license — Creative Commons license code, when set
• contentRating — Vimeo content rating, e.g. safe, unrated
• privacy — public or unlisted
• isEmbeddable, downloadAllowed, isPlayable, hasAudio
• isStaffPick, isHdr, isLive, isVod — Vimeo badges
• channelName, channelTotalVideos, channelTotalSubscribers — channel context
• channelId, channelSlug, channelUrl, channelDescription, channelCreatedAt, channelFollowers, channelCreatorName, channelCreatorUrl — fuller channel context
• sourceUrl — the page used to discover the video
• recordType: "video", scrapedAt

Output per creator

Emitted by searchCreators, or before a creator's videos with includeCreatorProfile.

• creatorId, username, displayName, url
• bio, shortBio, location, createdAt, avatarUrl
• isVerified, accountType
• videoCount, followerCount, followingCount, likeCount, albumCount
• websites[] — profile links
• sourceUrl, recordType: "creator", scrapedAt

Output per channel

Emitted by searchChannels, or before a channel's videos with includeChannelProfile.

• channelId, slug, name, url
• description, createdAt, updatedAt
• logoUrl, headerUrl
• creatorId, creatorName, creatorUrl
• videoCount, followerCount
• tags[], categories[], privacy
• sourceUrl, recordType: "channel", scrapedAt

Output per comment

Emitted by videoComments.

• commentId, videoId, videoUrl
• text
• authorId, authorName, authorUrl, authorAvatarUrl
• publishedAt
• replyCount — total replies, including zero
• sourceUrl, recordType: "comment", scrapedAt

Output per liker

Emitted by videoLikes.

• videoId, videoUrl
• userId, userName, userUrl, userAvatarUrl
• userLocation, userCreatedAt
• sourceUrl, recordType: "like", scrapedAt

Input

Field	Type	Default	Description
mode	string	byChannel	byChannel, byUser, videoDetails, staffPicks, search, searchCreators, searchChannels, category, tag, showcase, videoComments, videoLikes
channelSlugs	array	["staffpicks"]	Channel slugs or URLs (mode=byChannel)
usernames	array	–	Creator usernames, numeric IDs, user123 IDs or profile URLs (mode=byUser)
videoUrls	array	–	Vimeo video URLs or numeric IDs (mode=videoDetails, videoComments, videoLikes)
searchQueries	array	–	Keywords (mode=search, searchCreators, searchChannels)
categorySlugs	array	–	Category slugs such as documentary, animation, music, 2d, vfx, food (mode=category)
tagSlugs	array	–	Tags with or without #, e.g. nature, timelapse (mode=tag)
showcaseUrls	array	–	Showcase or album URLs, or numeric showcase IDs (mode=showcase)
maxItems	integer	20	Records per source (1–10,000)
sort	string	default	default, relevance, newest, oldest, mostViewed, mostLiked, mostCommented, longest, shortest, titleAZ, titleZA
filterCategory	string	any	Search only: any search-supported category
filterDuration	string	any	Search only: short, medium, long
filterResolution	string	any	Search only: 4k
filterPrice	string	any	Search only: free, paid
filterLicense	string	any	Search only: cc0, cc-by, cc-by-sa, cc-by-nd, cc-by-nc, cc-by-nc-sa, cc-by-nc-nd
filterUploaded	string	any	Search only: this-week, this-month, this-year
filterStaffPicked	boolean	false	Search only: Staff Picks only
filterHdr	string	any	Search only: anyHdr, dolbyVision, hdr10
filterVimeo360	string	any	Search only: spatial, 360
filterLive	boolean	false	Search only: currently live videos
includeCreatorProfile	boolean	false	Emit one creator record before their videos (mode=byUser)
includeChannelProfile	boolean	false	Emit one channel record before its videos (mode=byChannel, staffPicks)

Example: search with filters

{
  "mode": "search",
  "searchQueries": ["documentary", "short film"],
  "filterDuration": "short",
  "filterStaffPicked": true,
  "filterUploaded": "this-year",
  "sort": "mostViewed",
  "maxItems": 100
}

Example: a channel with its profile

{
  "mode": "byChannel",
  "channelSlugs": ["staffpicks", "https://vimeo.com/channels/animation/videos"],
  "includeChannelProfile": true,
  "sort": "newest",
  "maxItems": 50
}

Example: creator search and profile rows

{
  "mode": "searchCreators",
  "searchQueries": ["film", "animation studio"],
  "maxItems": 30
}

Example: comments and likers for specific videos

{
  "mode": "videoComments",
  "videoUrls": ["https://vimeo.com/22439234", "https://vimeo.com/showcase/6262886/video/1127880772"],
  "maxItems": 200
}

Use cases

• Content curation — monitor Staff Picks, channels and categories for new films worth featuring
• Creator research — compare a creator's upload history, follower counts and engagement
• Brand and agency monitoring — find brand films by keyword, category, license or upload date
• Audience analysis — export commenters and likers for community and influencer research
• Metadata archiving — keep a structured catalog of titles, tags, licenses, dates and badges
• Embed sourcing — collect player URLs and thumbnails for a curated video collection

FAQ

Do I need a Vimeo account, API key or proxy? No. Everything comes from public Vimeo pages and public video data. Fill in the input and run it.

Can I use any Vimeo URL in videoUrls? Yes. Plain video URLs, player URLs, channel paths, vanity URLs, showcase links, unlisted hash links and plain numeric IDs all resolve to the same video.

Why is viewCount missing on some videos? Some owners hide their play count. Vimeo does not expose it publicly, so the field is omitted rather than reported as zero. Likes and comments still come through, including genuine zeros.

Why do some videos have no tags or language? Those fields are optional on Vimeo. If the uploader did not set tags or Vimeo did not detect a language, the field is omitted. Older videos are more likely to have tags.

How many results can one run return? maxItems supports up to 10,000 records per source. Vimeo itself caps keyword search and tag listings at 10,000 results; split a broad query into narrower filters to cover more.

Why are some comments missing? Vimeo hides comments it classifies as spam or that the owner has filtered. The actor returns the publicly visible comment set.

What is the difference between byChannel and staffPicks? staffPicks is a shortcut for Vimeo's curated Staff Picks channel. byChannel accepts that slug too, plus any other public channel.

Can I scrape several creators, channels or queries in one run? Yes. Add multiple values to the matching list field; maxItems applies to each source, and duplicate videos are removed across sources.

Does maxItems apply to creator and channel searches? Yes, it caps each query's creator or channel results. Profile rows added by includeCreatorProfile or includeChannelProfile are extra context records, not part of the video count.

Is this affiliated with Vimeo? No. This is an independent, third-party actor that reads publicly available Vimeo data and is not operated by or affiliated with Vimeo.