Vimeo API. Videos, people and collections as JSON.
One video, a profile, a channel, a group, a showcase, a search or a tag feed, in one response shape. Name the id or handle, get JSON.
- 31 routes
- Typed not_found
- 1 credit per request
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
Vimeo data as JSON. You build the product.
Live Vimeo data in one response shape, with platform changes handled for you.
Vimeo, plus every other platform
One key and one response envelope for Vimeo and 56 more platforms.
Pricing you can reason about
One request, one credit. Know how far your balance will go before you run your next batch.
Live data on every request
Fetch public data when you ask for it.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
Regular jobs. Better rates.
Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.
What Vimeo data can you get?
31 endpoints, one API key. Every response comes back as live JSON in the same envelope.
Videos
Comments & credits
- +5 more users endpoints
Users
Channels
Groups
Showcases
Search
Catalog
On Demand
Browse all 31 Vimeo endpoints
Videos
Comments & credits
Users
Channels
Groups
Showcases
Search
Catalog
On Demand
What teams build with Vimeo data
Monitoring, enrichment, research and content workflows on Vimeo data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
Sources
+ 51 more platforms
One request
GET/v1/tiktok/profiles/
x-api-key: sk_live_••••••••
Same JSON shape
{
"data": {
"lookupStatus": "found",
"profile": {
"platform": "tiktok",
"handle": "charlidamelio",
"displayName": "charli d’amelio",
"verified": true
},
"metrics": {
"followers": 160263648
}
}
}Step 1
Create your free account
Get an API key with 100 requests included.
Step 2
Choose an endpoint
Pass a username, URL, keyword, or post ID.
Step 3
Get clean JSON
Use the response immediately or send it into your pipeline.
Works with your stack
Code, automate, or connect your AI.
TypeScript
n8n
- Make
- Apify
- MCP
- AI clients
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- Top up from $1.50 / 1k if you run out
- 25 team seats
- Up to 250 monitors
- Cancel anytime
- 30-day money-back guarantee
- Price locked while you stay
Need 1M+ credits, invoicing, or volume rates? Talk to us
Trust signals
DevHunt
Product Hunt
Uneed
Customers
Teams building on Social Fetch.
“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”
“Transcripts at volume from one endpoint. No broken scrapers for our small team to maintain.”
“Live profile data on every request. We never flag accounts from a stale cache.”
“Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”
Vimeo API: common questions
Is there a Vimeo API for videos, profiles and collections?
Yes. Social Fetch has 31 Vimeo routes under /v1/vimeo: video, embed, captions, comments, credits and likers; user profiles and their videos, likes, appearances, showcases, channels, groups, followers and following; channel, group and showcase records with their videos, subscribers or members; video, user, channel and group search; categories, tag videos and On Demand titles; and a browse route. Authenticate with your Social Fetch API key in x-api-key.
How do I identify a video, user, channel, group or showcase?
Videos take a digits-only id such as 76979871. Users take a vanity handle such as staff, a numeric id such as 152184, or user185091330. Channels take a slug such as staffpicks or a numeric id. Groups take a slug such as creativeapps or a numeric id. Showcases take a digits-only album id such as 11959649. On Demand titles take a slug or numeric id.
What does lookupStatus mean?
found means the record was returned. not_found means the video, user, channel, group, showcase or On Demand title does not exist, is private, is password protected or was removed; Vimeo does not distinguish those cases. HTTP 200 only means the request finished, so branch on data.lookupStatus. The embed route also returns restricted when the owner has switched embedding off.
How are lists paged?
Every list returns a page block with page, perPage, total, hasMore and nextCursor. Send page.nextCursor back as cursor to continue with the same filters; the cursor stops working if you change them. A page past the last one is an empty page with hasMore false. total is null when no total is available, and Vimeo's totals can drift between pages.
What are the limits I should know about?
The follower list stops at 10,000 rows and sets capped: true when that limit is reached. Following, and the user, channel, group and showcase video, member and subscriber lists, are deep and take limit up to 100. Showcase rows carry play counts where available, and playsAvailable is false when some counts are missing; the videos are still complete. Captions are available for some videos only: when they are withheld, the route answers 503 temporarily_unavailable and is not billed, rather than returning an empty list. A private or unlisted video without its privacy link reads not_found.
What do captions include?
Each track carries id, language, displayLanguage, kind, label, source, default, cuesAvailable and cues. A cue has startSeconds, endSeconds and text. captionsComplete is true only when every track and every cue file is included. The player block adds public player metadata such as owner, storyboard and stream quality labels.
Can I get comments and credits?
Yes. video.comments.list returns comments newest first with author, text, createdAt, editedAt and replyCount. video.credits.list returns each credited name, role and user, with creditsComplete saying whether every credit Vimeo reports was returned. video.likes.list returns the users who liked a video.
How much does the Vimeo API cost?
Every Vimeo route charges one credit per completed request, and each page of a list is billed separately. Check meta.creditsCharged on every response. New accounts start with 100 free credits.
Can I use the Vimeo routes from the SDK, agents or MCP?
Yes. Every Vimeo route has a method on client.vimeo in the TypeScript SDK, a typed MCP tool, and reachability through Ask (POST /v1/ask) in plain English. Use the typed routes for production jobs.
The Vimeo API in detailHow the Vimeo routes work, what they cost, and how they differ from the official API.
Why teams use Social Fetch for Vimeo
Social Fetch exposes 31 routes under /v1/vimeo. Video routes cover one video, its embed record, its caption and subtitle tracks with parsed cues, its comments, credits and likers, and a browse list. User routes cover a profile, the user's videos, likes, appearances, showcases, channels, groups, followers and following. Channel, group and showcase routes cover the record and its videos, plus subscribers or members where Vimeo lists them. Search covers videos, users, channels and groups, and the catalog routes cover categories, tag videos and On Demand titles.
Every response uses the { data, meta } envelope. Record lookups carry data.lookupStatus, so a deleted, private, password-protected or never-existing video, user, channel, group, showcase or On Demand title comes back as a typed not_found instead of an error. The embed route adds restricted, which means the owner has switched embedding off.
Lists page with an opaque cursor or a page number. The user, channel, group and showcase video, member and subscriber lists are deep and take limit up to 100 (default 25). The follower list stops at 10,000 rows; following is deep. Each page of a list is its own request.
How to call the Vimeo API
1. Create an API key
Sign up at Social Fetch and copy a key (
sfk_…). New accounts get 100 free credits, enough to try every Vimeo route on a few records.2. Pick the record and route
Use
GET /v1/vimeo/videos/76979871for one video orGET /v1/vimeo/users/staff/videosfor a profile's newest uploads. Video ids are digits, users accept a handle, a numeric id oruser<id>, and showcases take an id. Sendx-api-keyon every request.3. Page and branch
Check
data.lookupStatusbefore you store a row, keep requesting withpage.nextCursorwhilepage.hasMoreis true, and bill frommeta.creditsCharged.
What each Vimeo route returns
- A video's title, plain and HTML description, upload and release dates, tags, categories, thumbnails, owner, privacy, embed permission and public counts.
- Embed markup in one call, with
restrictedwhen the owner has turned embedding off. - Caption and subtitle tracks with language, kind, source and parsed
cues, pluscaptionsCompletewhen a cue file is unavailable. - Profiles with bio, links, account flags, counts, avatar sizes, social links and last-changed time.
- Channels, groups and showcases with their videos, subscribers or members, and the counts Vimeo reports.
- Video, user, channel and group search plus categories, tag feeds and On Demand titles with prices and genres.
How much does the Vimeo API cost?
Each Vimeo route charges one credit per completed request, shown on every endpoint page. Each page of a list is its own request. Credits never expire on pay-as-you-go packs, and meta.creditsCharged on every response is the billing source of truth.
Social Fetch vs the official Vimeo API
Vimeo's developer API is built for apps you register, each with its own permissions. Social Fetch gives you one key and one response shape across video, profile, channel, group, showcase, comment, credit and catalog routes. Lookups return typed not_found values, lists share the same page block, and a video's embed and captions sit next to the video record instead of in a separate surface.
Pull your first Vimeo data.
Run a live Vimeo request in the playground. 100 free credits, no card, JSON back in seconds.
No credit cardSign up in 30 seconds withGoogleGitHub