Reviews - v3

Our API output is in JSON format. Please use our Swagger Documentation for technical details about our Reviews output: https://api.commonsense.org/docs/v3/

Upgrading From Version 2

Check out the Upgrade Guide

Field Explanations

Metadata

API Field Name

Description

Age Rating

ageRating

The youngest appropriate age, based on title's specific content and overall child development guidelines

One-Line Summary

oneLiner

Short (60 character max) description that conveys key content guidance, with a hint of critical evaluation

Parents Need to Know

parentsNeedToKnow

The essential information parents need in order to make a well-informed decision; combines brief plot notes/cultural context with roll-up of top-line items from content grid

Content Grid

contentGrid

0-5 dot-scale rating for each rated category (Sex, Violence, Language, Positive Messages, Diverse Representations*, etc.), indicating the amount of each type of content (from "not present" to "a lot")*

*For Diverse Representations, API V3 includes values for positive/display flag

Content Grid Details

contentGrid

In-depth list/summary of information for each rated category (Sex, Violence, Language, Positive Messages, etc.), with 0-5 dot ratings for each, indicating amount of each type of content (from "not present" to "a lot")

Topics & Themes

topics

Checklist of tags related to subject-based categories (ex. Superheroes, STEM, Holidays, Sports, etc.)*

*Full list of tags available upon request

Character Strengths

characterStrengths

Checklist of 11 character-based tags (ex. compassion, empathy, perseverance, teamwork), applied based on specific criteria

Handpicked Alternatives

alternatives

At least three (often more) media titles chosen by reviewers/editors as relevant to the title being reviewed

Conversation Starters

talkingPoints

Discussion questions to help families think critically about the media they consume

Plot Summary

description

One-paragraph summary of the story

Is It Any Good?

anyGood

One- to two-paragraph critical analysis of the media title being reviewed

Quality Rating (Stars)

stars

1-5 star rating based on the reviewer's quality assessment of the title being reviewed

User Reviews

stats

Reviews submitted by registered parent and teen users of the Common Sense Media site

Common Sense Selection

awards

Binary field used to identify recipients of the Common Sense Selection Seal, which recognizes titles of exceptional quality and impact

General Metadata

N/A

Various field names included representing base data such as cast, director, genre, studio, release date, etc.

  • The above reflects English Ratings & Reviews only; metadata and descriptions corresponding to Common Sense Media's Spanish Ratings & Reviews available upon request
  • For additional reference: How We Rate and Review Common Sense Selections

Field Guide

Annotated screenshot of a movie review with API field names