> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/vimeo/ondemand-slug>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/vimeo/ondemand-slug.mdx>

---

# 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}` 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.

## Request

- **Endpoint:** `GET /v1/vimeo/ondemand/{slug}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by slug or id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/vimeo/ondemand/slug/get)
- **Platform page:** [/platforms/vimeo](https://www.socialfetch.dev/platforms/vimeo)

## 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.