Social Fetch
Start for freeStart free
Vimeo hub

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Vimeo Tag Videos API 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.

Other Vimeo endpoints