Data Dictionary - Name

nameId

The unique IMDb ID for the name in question. Each IMDb ID appears exactly once.

remappedTo

It is possible that two IMDb IDs can be created for a single entity within our system before IMDb identify that they actually represent the same person or title. When this happens, we maintain the data associated with both identifiers in the data set, duplicating the data. If there are duplicate name entities for a person, remappedTo provides the IMDb ID of the primary name entity for this person.

See “Duplicate IDs" in the “Changes to Entities and Resolving IDs” section of “Key Concepts” for more information.

name

The primary name by which this person is known, usually the one by which they are most often credited. For more information about how IMDb defines the primary name see IMDb help site.

awards

A list of awards that this person has won or been nominated for. This includes the name and category of the award, the name and year of the award event, the titles they were nominated for, and whether the person won the award. Note that winner may be false because the person is known not to have won the award (where the awards event occured in the past) or because the winner is not yet known (where the awards event occurs in the future, but the nominations have been announced). If 'winner' is true that means the awards event has already occured, and the person won the award. Please also note that titles may be missing from the record in case the nomination is not related to a specific title (e.g "life-time achievement award").

Example

{
  "awards": [
    {
      "year": 1958,
      "awardName": "Golden Globe",
      "category": "Best Actor - Drama",
      "titles": ["tt0050933"],
      "winner": false,
      "event": "Golden Globes, USA"
    },
    ...
  ]
}

death

If applicable, details regarding the person’s death. Fields include (where known) deathStatus, deathDate, deathCause and deathLocation. Note that there is no ‘alive’ status, so absence of death details may imply that the person is alive, or that death details are unknown.

Example

{
  "death": {
    "deathCause": "stroke",
    "deathDate": "1969-05-27",
    "deathLocation": "Los Angeles, California, USA",
    "deathStatus": "DEAD"
  },
  ...
}

filmography

The filmography for this name as a list of credits. Each credit is within a "category" such as "actress", "director" or "editorial_department". For cast categories (e.g. "actor"), we include the roles that the person played and the billing they had in the end credits (if available). For crew categories (e.g. "writer") we include the more specific "jobs" that the person was credited with if applicable. Lists of credits, roles, and jobs are each in on-screen credits order.

Credits can have a list of attributes. At the moment we provide the following attributes:

• "uncredited": signals that while the person performed this role on the title, they were not present in the title's end credits.
• "voice": signals that this person provided a voice only performance for this title.

Additional information about these attributes can be found on IMDb help site.

For episodic credits we only include the series in the list. To get full information on which episodes were worked on, look at the episode credits in the title file.

Example

A cast credit

{
  "filmography": [
    {
      "titleId": "tt0050083",
      "category": "actor",
      "billing": 8,
      "roles": ["Juror 8"]
    },
    ...
  ]
}

A crew credit

{
  "filmography": [
    {
      "titleId": "tt0052462",
      "category": "producer",
      "jobs": ["executive producer"]
    },
    ...
  ]
}

An uncredited credit

{
  "filmography": [
    {
      "titleId": "tt0050083",
      "category": "actor",
      "roles": ["Judge"],
      "attributes": ["uncredited"]
    }
    ...
  ]
}

knownFor

A short list of IMDb title IDs for the titles in which this person is most well known for being involved, and the category of job that they had on that title (e.g. "actor" or "director"). This is always a subset of filmography but the selection and order is determined by IMDb. For more details see IMDb help site. For further details on their involvement see the filmography entry, or the creditsByCategory entry on the title in question.

Example

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

trademarks

Descriptions of a person's recognizable trait, usually something repeated over a significant proportion of their films, or distinguishing information that sets them apart from most other people in the industry. For more details see IMDb help site.

Example

{
  "trademarks": [
    "Deep husky voice",
    "Cat-like green eyes",
    ...
  ]
}