Social Fetch
Start for freeStart free
Vimeo hub

Vimeo On Demand API

A title's public storefront record: description, genres, rent and buy prices, owner, film and trailer, without signed playback URLs.

GET /v1/vimeo/ondemand/{slug}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/vimeo/ondemand/{slug} takes a slug such as pariah or a numeric id. On found, data.onDemand carries id, name, description, type, url, domainUrl, contentRating, theme, colors, publish, preorder, rating, poster, thumbnail, background, genres, rent, buy, subscription, episodes, owner, film, trailer and counts.

rent, buy and subscription each carry active, prices (one entry per currency), url and period. film and trailer describe the public video behind the title. Signed playback and embed URLs are never returned. A title that does not exist or is not public reads lookupStatus: not_found with onDemand null.

Vimeo On Demand API FAQ

What does a title record include?

id, name, description, type, url, domainUrl, contentRating, theme, colors, publish, preorder, rating, poster, thumbnail, background, genres, rent, buy, subscription, episodes, owner, film, trailer and counts.

How are prices returned?

rent, buy and subscription each have active, prices, url and period. prices is a list with a currency code and an amount per currency, so the same title can be priced in several currencies.

Are playback URLs returned?

No. The route returns the public title record, poster and thumbnail images, genre links and the film and trailer descriptions. Signed playback and embed URLs are not exposed.

How many credits does an On Demand lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Vimeo endpoints