Titles Data Dictionary

Fresh

The Titles dataset is the most comprehensive bulk data schema, containing complete metadata records for every title in the IMDb database: movies, TV series, TV episodes, mini-series, short films, documentaries, and video games.

Top-Level Fields

Field	Type	Description
titleId	string	IMDb title ID (tt + 7+ digits)
remappedTo	string	Canonical ID if this entry was merged
originalTitle	string	Title in original language of production
akas	array	Alternative titles (AKAs) with locale info
titleDisplay	object	Display-formatted title text
awards	array	Award nominations and wins
creditsByCategory	object	Full cast and crew by job category
principalCastMembers	array	Curated principal cast
principalCrewMembers	array	Curated principal crew
certificates	array	Content rating certificates by country
color	array	Color/black-and-white classification
companies	object	Production, distribution, and other companies
countries	array	Countries of origin
episodeInfo	object	For episodes: series ID, season, episode number
seriesInfo	object	For series: start/end years, episode IDs
episodeTitleIds	array	For series: list of all episode IDs
officialSiteLinks	array	Official website URLs
genres	array	Genre classifications
image	object	Primary image (poster) metadata
imdbUrl	string	Full URL to IMDb title page
isAdult	boolean	Whether the title is classified as adult content
keywords	array	User-contributed keywords with vote counts
languages	array	Languages used in the title
locations	object	Filming locations
movieConnections	array	Connections to other titles (remakes, sequels, etc.)
plot	string	Standard plot summary
plotShort	string	Short (one-line) plot summary
plotMedium	string	Medium-length plot summary
plotLong	string	Full detailed plot summary
releaseDates	array	Release dates by country/region
productionStatus	object	Current production stage
runtimeMinutes	integer	Total runtime in minutes
taglines	array	Marketing taglines
titleType	string	Type classification (movie, tvSeries, etc.)
imdbRating	object	Aggregate rating and vote count
year	integer	Primary release year
trivia	array	Trivia items with interest scores
goofs	array	Documented errors/goofs

---

titleId and remappedTo

{
  "titleId": "tt0068646",
  "originalTitle": "The Godfather"
}

If remapped:

{
  "titleId": "tt9999999",
  "remappedTo": "tt0068646"
}

---

akas

Alternative known-as titles, covering localized releases and alternate translations.

{
  "akas": [
    {
      "country": "IT",
      "language": "it",
      "title": "Il Padrino"
    },
    {
      "country": "ES",
      "language": "es",
      "title": "El Padrino"
    },
    {
      "country": "US",
      "language": "en",
      "title": "The Godfather"
    }
  ]
}

---

creditsByCategory

Full credits organized by job category. Each category key maps to an object with cast or crew arrays.

{
  "creditsByCategory": {
    "cast": {
      "cast": [
        {
          "nameId": "nm0000008",
          "roles": [{ "character": "Don Vito Corleone" }],
          "billing": 1,
          "attributes": []
        }
      ]
    },
    "director": {
      "crew": [
        {
          "nameId": "nm0000338",
          "jobs": ["Director"],
          "attributes": []
        }
      ]
    },
    "writer": {
      "crew": [
        {
          "nameId": "nm0000338",
          "jobs": ["Screenplay"],
          "attributes": []
        }
      ]
    }
  }
}

---

principalCastMembers and principalCrewMembers

Curated subsets of the most significant cast and crew.

{
  "principalCastMembers": [
    {
      "nameId": "nm0000008",
      "roles": [{ "character": "Don Vito Corleone" }],
      "billing": 1
    }
  ],
  "principalCrewMembers": [
    {
      "nameId": "nm0000338",
      "category": "director"
    }
  ]
}

---

certificates

Content rating certifications from national rating bodies.

{
  "certificates": [
    {
      "country": "US",
      "rating": "R",
      "ratingsBody": "MPAA",
      "reason": "Violence, language"
    },
    {
      "country": "GB",
      "rating": "18",
      "ratingsBody": "BBFC",
      "reason": ""
    }
  ]
}

---

companies

Companies involved in the production and distribution of the title, organized by role type.

{
  "companies": {
    "production": [
      {
        "companyId": "co0023400",
        "companyName": "Paramount Pictures",
        "country": "US",
        "attributes": []
      }
    ],
    "distribution": [
      {
        "companyId": "co0023400",
        "companyName": "Paramount Pictures",
        "country": "US",
        "attributes": ["theatrical"]
      }
    ],
    "specialEffects": [],
    "miscellaneous": []
  }
}

---

episodeInfo and seriesInfo

For Episodes (episodeInfo)

{
  "episodeInfo": {
    "seriesTitleId": "tt0903747",
    "seasonNumber": 1,
    "episodeNumber": 1
  }
}

For Series (seriesInfo)

{
  "seriesInfo": {
    "startYear": 2008,
    "endYear": 2013,
    "episodeTitleIds": ["tt0959621", "tt1054487"]
  }
}

The episodeTitleIds array lists all episode IDs that belong to the series. For large series this can be a very long array.

---

image

Primary image (typically the poster or cover art) for the title.

{
  "image": {
    "height": 1000,
    "id": "rm1234567890",
    "url": "https://m.media-amazon.com/images/M/...",
    "width": 675
  }
}

---

imdbRating

{
  "imdbRating": {
    "rating": 9.2,
    "numberOfVotes": 1900000
  }
}

---

keywords

{
  "keywords": [
    {
      "category": "theme",
      "keyword": "organized crime",
      "votes": 4521
    },
    {
      "category": "theme",
      "keyword": "family",
      "votes": 3102
    }
  ]
}

---

locations

{
  "locations": {
    "scenes": [
      {
        "place": "New York City, New York, USA",
        "attributes": ["exterior"]
      }
    ]
  }
}

---

movieConnections

Links to related titles — remakes, sequels, prequels, spin-offs, etc.

{
  "movieConnections": [
    {
      "type": "follows",
      "titleId": "tt0068646",
      "text": "The original Godfather film"
    },
    {
      "type": "sequel",
      "titleId": "tt0071562",
      "text": "The Godfather Part II"
    }
  ]
}

---

releaseDates

{
  "releaseDates": [
    {
      "country": "US",
      "date": "1972-03-24",
      "attributes": ["limited"]
    },
    {
      "country": "US",
      "date": "1972-03-24",
      "attributes": ["wide"]
    }
  ]
}

---

trivia and goofs

{
  "trivia": [
    {
      "interestScore": 4521,
      "isSpoiler": false,
      "category": "production",
      "text": "Francis Ford Coppola was not the studio's first choice to direct."
    }
  ],
  "goofs": [
    {
      "interestScore": 312,
      "isSpoiler": false,
      "category": "continuity",
      "text": "The coffee level changes between shots during the restaurant scene."
    }
  ]
}

---

titleType Values

Value	Description
movie	Feature film
tvSeries	TV series
tvEpisode	Individual TV episode
tvMiniSeries	Limited series
tvMovie	Made-for-TV movie
tvSpecial	TV special
short	Short film
videoGame	Video game
video	Direct-to-video release