Names Data Dictionary

Fresh

The Names dataset contains records for every person in the IMDb database — actors, directors, writers, producers, composers, cinematographers, and all other credited crew. One JSON Lines record per person.

Top-Level Fields

Field	Type	Description
nameId	string	IMDb name ID (format: nm + 7+ digits)
remappedTo	string	If this ID has been merged into another, the canonical ID
name	object	Person's full name
awards	array	Award nominations and wins
death	object	Death information (omitted if person is living)
filmography	object	All credits organized by role type
knownFor	array	Curated list of most notable titles
trademarks	array	Known phrases, mannerisms, or stylistic signatures

---

nameId

{
  "nameId": "nm0000020"
}

---

name

{
  "name": {
    "nameText": "Henry Fonda",
    "nameTextSortable": "Fonda, Henry"
  }
}

---

awards

Array of award nominations. Each entry represents one nomination or win.

{
  "awards": [
    {
      "year": 1982,
      "awardName": "Academy Awards",
      "category": "Best Actor in a Leading Role",
      "titles": ["tt0082781"],
      "winner": true,
      "event": "Oscars"
    },
    {
      "year": 1958,
      "awardName": "Academy Awards",
      "category": "Best Actor in a Leading Role",
      "titles": ["tt0050083"],
      "winner": false,
      "event": "Oscars"
    }
  ]
}

Field	Description
year	Year of the award ceremony
awardName	Full name of the award
category	Specific category within the award
titles	Array of title IDs associated with the nomination
winner	true if the nomination resulted in a win
event	Short name of the award ceremony

---

death

Only present for deceased individuals. Omitted entirely for living persons.

{
  "death": {
    "deathStatus": "DEAD",
    "deathDate": {
      "year": 1982,
      "month": 8,
      "day": 12
    },
    "deathCause": "Cancer",
    "deathLocation": "Los Angeles, California, USA"
  }
}

---

filmography

Contains all credits for the person, divided by role type.

cast

{
  "filmography": {
    "cast": [
      {
        "titleId": "tt0050083",
        "roles": [
          {
            "character": "Juror 8",
            "characterId": "ch0000000"
          }
        ],
        "billing": 1,
        "attributes": []
      },
      {
        "titleId": "tt0082781",
        "roles": [
          {
            "character": "Norman Thayer Jr.",
            "characterId": "ch0000001"
          }
        ],
        "billing": 1,
        "attributes": ["uncredited"]
      }
    ]
  }
}

crew

{
  "filmography": {
    "crew": [
      {
        "titleId": "tt0050083",
        "category": "producer",
        "jobs": ["Executive Producer"],
        "attributes": []
      }
    ]
  }
}

Field	Description
titleId	IMDb title ID for the credited work
roles	Array of character roles (cast only)
character	Character name
characterId	IMDb character identifier
billing	Billing position in the credits
attributes	Special credit notes, e.g., "uncredited", "voice"
category	Job category for crew (e.g., "director", "writer")
jobs	Specific job titles within the category

---

knownFor

A curated list of the person's most notable titles, as determined by IMDb editorial.

{
  "knownFor": [
    {
      "titleId": "tt0050083",
      "category": "actor"
    },
    {
      "titleId": "tt0082781",
      "category": "actor"
    }
  ]
}

---

trademarks

Distinctive phrases, mannerisms, or recurring stylistic elements associated with the person.

{
  "trademarks": [
    "Known for his laconic acting style and understated emotional depth.",
    "Frequently played morally upright characters facing ethical dilemmas."
  ]
}