Skip to main content
POST
/imdb/titles/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
keyword
string | null
title_type
enum<string>[] | null
Available options:
movie,
tvSeries,
tvMiniSeries,
tvMovie,
tvSpecial,
tvEpisode,
tvShort,
short,
video,
videoGame,
musicVideo,
podcastSeries,
podcastEpisode
title_type_exclude
enum<string>[] | null
Available options:
movie,
tvSeries,
tvMiniSeries,
tvMovie,
tvSpecial,
tvEpisode,
tvShort,
short,
video,
videoGame,
musicVideo,
podcastSeries,
podcastEpisode
genres
enum<string>[] | null
Available options:
Action,
Adult,
Adventure,
Animation,
Biography,
Comedy,
Crime,
Documentary,
Drama,
Family,
Fantasy,
Film-Noir,
Game-Show,
History,
Horror,
Music,
Musical,
Mystery,
News,
Reality-TV,
Romance,
Sci-Fi,
Short,
Sport,
Talk-Show,
Thriller,
War,
Western
genres_exclude
enum<string>[] | null
Available options:
Action,
Adult,
Adventure,
Animation,
Biography,
Comedy,
Crime,
Documentary,
Drama,
Family,
Fantasy,
Film-Noir,
Game-Show,
History,
Horror,
Music,
Musical,
Mystery,
News,
Reality-TV,
Romance,
Sci-Fi,
Short,
Sport,
Talk-Show,
Thriller,
War,
Western
rating_min
number | null
Required range: 0 <= x <= 10
rating_max
number | null
Required range: 0 <= x <= 10
votes_min
integer | null
Required range: x >= 0
votes_max
integer | null
Required range: x >= 0
release_date_from
string | null
release_date_to
string | null
runtime_min
integer | null
Required range: x >= 0
runtime_max
integer | null
Required range: x >= 0
countries
string[] | null
countries_exclude
string[] | null
languages
string[] | null
us_certificates
enum<string>[] | null
Available options:
G,
PG,
PG-13,
R,
NC-17
color
enum<string>[] | null
Available options:
COLOR,
BLACK_AND_WHITE,
COLORIZED,
ACES
keywords
string[] | null
companies
string[] | null
cast_or_crew
string[] | null
awards
enum<string>[] | null
Available options:
OSCAR_WINNING,
OSCAR_NOMINATED,
EMMY_WINNING,
EMMY_NOMINATED,
GOLDEN_GLOBE_WINNING,
GOLDEN_GLOBE_NOMINATED
ranked_lists
enum<string>[] | null
Available options:
TOP_RATED_MOVIES,
LOWEST_RATED_MOVIES,
MOVIE_METER,
TV_METER,
TITLE_METER
interests
string[] | null
adult
enum<string> | null
Available options:
EXCLUDE_ADULT,
INCLUDE_ADULT,
ONLY_ADULT
sort
enum<string>
default:POPULARITY
Available options:
POPULARITY,
USER_RATING,
USER_RATING_COUNT,
RELEASE_DATE,
RUNTIME,
YEAR,
BOX_OFFICE_GROSS_DOMESTIC,
METACRITIC_SCORE,
RANKING
sort_order
enum<string>
default:ASC
Available options:
ASC,
DESC
country
string | null
language
string | null

Response

Successful Response

id
string
required
url
string
required
@type
string
default:ImdbTitleSearchResult
title_text
string | null
original_title
string | null
type_id
string | null
type_name
string | null
year
integer | null
end_year
integer | null
rating
number | null
vote_count
integer | null
runtime_minutes
integer | null
certificate
string | null
plot
string | null
genres
string[]
image
string | null