> **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/videos-search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/vimeo/videos-search.mdx>

---

# Vimeo Video Search API

Find videos by term, then sort by relevance, date, plays, likes, comments, duration or title. Licence and trending filters included.

`GET /v1/vimeo/videos/search?query=cats` returns `data.videos` and `data.total`, with each row a full video record. `query` is required unless `trending=true`, and accepts up to 200 characters. `sort` takes `relevant`, `date`, `alphabetical`, `plays`, `likes`, `comments` or `duration`. `license` filters to `CC` or `CC-BY`. `trending=true` returns the trending list instead of a query match: `query` and `sort` are ignored, and it cannot be combined with `license`.

Video search pages accept `page` up to 400, `limit` up to 100 and a `cursor`. The search routes stop at 10,000 rows. There is no `lookupStatus` on search: an empty `videos` array with `hasMore: false` is a real result.

## Request

- **Endpoint:** `GET /v1/vimeo/videos/search`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by term
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/vimeo/videos/search/get)
- **Platform page:** [/platforms/vimeo](https://www.socialfetch.dev/platforms/vimeo)

## FAQ

### Which sort values can I use?

relevant, date, alphabetical, plays, likes, comments or duration. The default order is Vimeo's relevance order.

### How does the trending filter work?

Set trending=true to return the trending videos without a query. query and sort are ignored, and it cannot be combined with license.

### How deep can I page?

page accepts up to 400, limit up to 100, and a cursor continues from a previous page. The search routes stop at 10,000 rows, so a page past that cap is empty.

### How many credits does a search page 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.