Skip to main content
POST /v1/data/imdb/videos/run Pricing: $0.003 per video ($3.00 per 1,000).

Ways to call it

  • Search Queries: set searchQueries (optional: type, yearFrom, yearTo, maxResults)
  • Title IDs: set titleIds (optional: type, yearFrom, yearTo, maxResults)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
One or more search queries. One request reads them all.
string[]
One or more title ids. One request reads them all.
string
Type to use.Allowed values: movie (Movies only), tv (TV shows only).
integer
Year From as a whole number.Min 1874; max 2100.
integer
Year To as a whole number.Min 1874; max 2100.
integer
default:"100"
How many videos to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one video, keyed by these fields.

Example response

Abridged: long text and lists are shortened.