Skip to main content
POST
/rottentomatoes/movies/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
category
enum<string>
default:movies_at_home
Available options:
movies_in_theaters,
movies_at_home,
movies_coming_soon
sort
enum<string>
default:popular
Available options:
popular,
newest,
top_box_office
genres
enum<string>[]
Available options:
action,
adventure,
animation,
anime,
biography,
comedy,
crime,
documentary,
drama,
entertainment,
faith_and_spirituality,
fantasy,
game_show,
health_and_wellness,
history,
holiday,
horror,
house_and_garden,
kids_and_family,
lgbtq,
music,
musical,
mystery_and_thriller,
nature,
news,
reality,
romance,
sci_fi,
short,
soap,
special_interest,
sports,
stand_up,
talk_show,
travel,
variety,
war,
western
ratings
enum<string>[]
Available options:
g,
pg,
pg_13,
r,
nc_17,
nr,
ur
tomatometer
enum<string> | null
Available options:
certified_fresh,
fresh,
rotten
popcornmeter
enum<string> | null
Available options:
verified_hot,
upright,
spilled
affiliates
enum<string>[]
Available options:
theaters,
fandango-at-home,
apple-tv,
apple-tv-plus,
netflix,
prime-video,
disney-plus,
max,
peacock,
hulu,
paramount-plus,
amc-plus,
acorn-tv

Response

Successful Response

url
string
required
@type
string
default:RottentomatoesBrowseItem
id
string | null
media_type
string | null
slug
string | null
name
string | null
release_text
string | null
image
string | null
tomatometer
integer | null
popcornmeter
integer | null