Skip to main content
POST
/vimeo/videos/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
query
string
required
Minimum string length: 1
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
sort
enum<string>
default:relevance
Available options:
relevance,
newest,
popular,
title_asc,
title_desc,
longest,
shortest
category
enum<string> | null
Available options:
travel,
documentary,
experimental,
animation,
narrative,
music,
educational,
sports,
industry,
art,
brandedcontent,
instructionals,
adsandcommercials,
cameratechniques,
events,
product,
trailers,
comedy,
personal,
journalism,
fashion,
wedding,
talks,
food,
identsandanimatedlogos,
titlesandcredits
duration
enum<string> | null
Available options:
short,
medium,
long
license
enum<string> | null
Available options:
by-nc-nd,
by,
by-nc,
by-nc-sa,
by-nd,
by-sa,
cc0
resolution
enum<string> | null
Available options:
4k
hdr
enum<string> | null
Available options:
hdr,
dolby_vision,
hdr10,
hdr10+
spatial
enum<string> | null
Available options:
spatial,
360
price
enum<string> | null
Available options:
free,
paid
live_event
enum<string> | null
Available options:
now
uploaded
enum<string> | null
Available options:
this-year,
this-month,
this-week,
today
staff_picks
boolean
default:false

Response

Successful Response

id
string
required
@type
string
default:VimeoVideo
video_title
string | null
url
string | null
image
string | null
duration
integer | null
width
integer | null
height
integer | null
fps
number | null
user
object | null
view_count
integer | null
like_count
integer | null
comment_count
integer | null
tags
string[]
categories
string[]
license
string | null
privacy
string | null
content_rating
string[]
language
string | null
is_spatial
boolean
default:false
is_live
boolean
default:false
is_hdr
boolean
default:false
unlisted_hash
string | null
files
object[]
subtitles
object[]
created_at
integer | null