IMDb API Documentation

Data Dictionary ​

Fresh

The IMDb bulk data is organized into six distinct dataset categories. This data dictionary provides field-level documentation for each schema, including data types, nested structures, and JSON examples.

Datasets ​

Names ​

Records for every person credited on IMDb — actors, directors, writers, producers, and other crew. Includes filmography, known-for titles, awards, biographical data, and trademarks.

Key fields: nameId, name, filmography, knownFor, awards, death, trademarks

Titles ​

Records for every title — movies, TV series, episodes, mini-series, shorts, and video games. The most comprehensive dataset, covering all metadata from ratings and credits to technical specifications, plot, and release data.

Key fields: titleId, originalTitle, titleType, year, runtimeMinutes, genres, imdbRating, creditsByCategory, episodeInfo, seriesInfo, image, plot, releaseDates, certificates

Box Office ​

Four sub-datasets covering financial performance data. Requires the IMDb and Box Office Mojo product subscription.

  • boxoffice_title_budgets_v1 — Production budgets
  • boxoffice_title_grosses_v1 — Lifetime gross revenue by territory
  • boxoffice_title_opening_weekends_v1 — Opening weekend figures
  • boxoffice_title_grosses_timeseries_v1 — Weekly gross data

Meters ​

Popularity ranking datasets updated daily. Four meter types, each covering different segments:

  • TITLEmeter — Top 5,000 titles overall
  • TVmeter — Top 2,000 TV shows
  • MOVIEmeter — Top 2,000 movies
  • STARmeter — Top 5,000 names (people)

Parents Guide ​

Content advisory data for titles, covering five categories with severity ratings and vote counts. Available in standard and advanced versions (advanced includes individual item descriptions).

Categories: Sex & Nudity, Violence & Gore, Profanity, Alcohol/Drugs/Smoking, Frightening & Intense Scenes

GeoMeters ​

Region-specific popularity rankings for major markets worldwide. Same four meter types as the global meters, but segmented by country or region.

Available regions: APAC, EMEA, NA, LATAM, plus individual country codes for AU, BR, CA, DE, ES, FR, GB, IN, IT, JP, KR, MX, US.

IMDb API Documentation — Internal Reference