Developer Center
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
