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

---

# Vimeo Tag Videos API

Videos carrying a tag, sortable by plays, with full records and a reported total. Tags in any script work.

`GET /v1/vimeo/tags/{tag}/videos` returns `data.videos`, `data.total` and `data.page`. Each row is the standard video record with title, description, dates, tags, thumbnails, owner, privacy, embed permission and stats. The tag can be in any script, for example `cats` or `猫`, and may not contain `/`, `?`, `#` or control characters.

`sort` accepts `plays`. The route takes `page` up to 20,000, `limit` up to 100 and a `cursor`. A tag Vimeo does not know reads `found` with an empty page rather than `not_found`, so an empty list is not an error. This tag route is separate from the browse route, which also accepts a tag.

## Request

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

## FAQ

### Can I use non-Latin tags?

Yes. The tag accepts any script, for example cats or 猫. It may not contain a slash, question mark, hash or control characters.

### What does an unknown tag return?

A found lookup with an empty videos array and hasMore false. An unknown tag is not an error, so check for rows rather than lookupStatus.

### How deep can I page?

page accepts up to 20,000, limit up to 100, and a cursor continues from a previous page. sort is plays.

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