Search Vimeo videos
Search Vimeo videos by term, with sort, licence and trending filters.
Headers
Get your API keyAPI key (`sfk_...`)
Search term, e.g. `cats`. Required unless `trending=true`; ignored with `trending=true`.
min 1 chars · max 200 chars
Order of the results. Ignored with `trending=true`. One of: relevant, date, alphabetical, plays, likes, comments, duration.
one of: relevant, date, alphabetical, plays, likes, comments, duration
Creative Commons filter: `CC` (any) or `CC-BY`.
one of: CC, CC-BY
Return the trending videos instead of a query match. `query` and `sort` are ignored. Cannot be combined with `license`.
Page number, 1-400. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page.
≥ 1 · ≤ 400
Rows per page, 1-100. Default: 25.
≥ 1 · ≤ 100
Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters.
min 1 chars · max 512 chars
Endpoint-specific response payload.
Videos, in order.
Video id.
≥ 0
Video page URL.
Title.
Description as plain text; null when empty.
Description as Vimeo formats it, line breaks included; null when it is empty.
When the video was uploaded, converted to UTC from Vimeo's US Eastern time.
When the record was last changed.
When the owner says the video was released.
Length in whole seconds.
≥ 0
Source width in pixels.
≥ 0
Source height in pixels.
≥ 0
Derived from width and height.
one of: landscape, portrait, square, null
Tags, without the leading separator.
Vimeo category names.
Language code the owner set.
Licence the owner set.
Vimeo content-rating labels.
The video's privacy settings.
Who may watch: `anybody`, `ptv` and similar.
Embedding permission: `public`, `private` or `whitelist`.
Who may comment: `anybody` and similar.
Where the video may be embedded.
one of: anywhere, approved, nowhere, null
Thumbnails in the sizes Vimeo offers.
Thumbnail, 100x75.
Thumbnail, 200x150.
Thumbnail, 640 pixels wide.
Thumbnail without a size suffix.
The user a record belongs to.
Vimeo user id.
≥ 0
Display name.
Vanity handle, or the `user<id>` form.
Profile page URL.
Avatars when the row carries them; null when the list row does not.
Square avatar, 30 pixels.
Square avatar, 75 pixels.
Square avatar, 100 pixels.
Square avatar, 300 pixels.
The avatar without a size suffix.
Profile-page portrait, 360 pixels.
Counts. Hidden counts are null, not zero.
Plays, or null when the uploader hides stats.
≥ 0
Likes, or null when the uploader hides stats.
≥ 0
Comments, or null when the uploader hides stats.
≥ 0
Total matches Vimeo reports, when it does.
≥ 0
Pagination state for the current page. A short page is not the end: hasMore says whether another page exists.
Current page number (1-based).
≥ 0
Rows per page, when fixed; otherwise null.
≥ 0
How many rows match; null when no total is available. Vimeo's totals drift between pages.
≥ 0
Whether another page is available. A page can be shorter than `perPage` when a row is unavailable.
Opaque cursor for the next request; null on the last page or an empty page.
True when Vimeo stops this list before its end, so more rows exist beyond the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/vimeo/videos/search?query=cats&limit=25" \
-H "x-api-key: YOUR_API_KEY"Responses
A page of video search results.