Data Dictionary - Parents Guide

parentsGuide

While IMDb includes MPA and Certification ratings from around the world, the Parents Guide provides parents, guardians and audiences additional information about titles that cannot be fully conveyed by certificates, since the beliefs that parents and guardians want to instill in their children can vary greatly. Drawing from the collective insights of the global IMDb community, IMDb Parents’ Guides provide detailed information and warnings about adult/potentially-harmful content of titles.

category

The specific theme for which the title is being evaluated. Categories include: "Sex & Nudity", "Violence & Gore", "Profanity", "Alcohol, Drugs & Smoking", and "Frightening & Intense Scenes".

severity

The overall rating of content intensity for a given category, determined by user votes. Can be "None", "Mild", "Moderate", or "Severe". The severity is based on the highest number of votes received for any severity level. For example, if "Moderate" has the most votes under "Violence & Gore", then this category will have "Moderate" as the overall severity. In case of a tie between two severity levels, the higher severity is chosen.

votes

Contains the vote counts for each severity level within a category:

• noneVotes: Number of users who rated the category as having no concerning content
• mildVotes: Number of users who rated the category as having mild content
• moderateVotes: Number of users who rated the category as having moderate content
• severeVotes: Number of users who rated the category as having severe content

parentsGuideItems

Text descriptions depicting the adult/potentially-harmful scenes and on-screen actions/dialog within each category. (Note: This field is available in the advanced version of Parents Guide dataset. If you would like to upgrade the Parents Guide dataset to access these text descriptions, contact imdb-licensing-support@imdb.com)

More information on IMDb Parents Guide along with our guidelines for contributions can be found on IMDb help pages.

Example

{
   "parentsGuide":[
     {
       "category": "Profanity",
       "severity": "None",
       "votes": {
         "noneVotes": 9,
         "mildVotes": 1,
         "moderateVotes": 0,
         "severeVotes": 2
       },
       "parentsGuideItems": [
         {
           "text": "No curse words, family-friendly movie.",
           "isSpoiler": false
         },
         {
           "text": "The narrator, who sometimes \"voices\" what the animals are \"saying\", exclaims \"God\" several times over.",
           "isSpoiler": false
         }
       ]
     },
     {
       "category": "Violence & Gore",
       "severity": "Moderate",
       "votes": {
         "noneVotes": 6,
         "mildVotes": 6,
         "moderateVotes": 5,
         "severeVotes": 7
       },
       "parentsGuideItems": [
         {
           "text": "A crab seizes onto a cat's upper lip/nose. Cat appears to be in pain.",
           "isSpoiler": false
         },
         {
           "text": "Whilst various animals interact with one another; sometimes interactions are \"hunter-on-huntee\". Perilous situations (a bear hunting down a cat). Humor is often used to diffuse tense situations - - lessens the tension for viewers.",
           "isSpoiler": false
         }
       ]
     },
     ...
   ]
}

Note that in this example, parentsGuideItems will only be available in the advanced version of the Parents Guide.