Common Sense Media Review

Schema for a single review returned from the Common Sense Media Reviews API v3.

AppsBooksMediaMoviesNon-ProfitPodcastsRatingsReviewsTelevisionVideo GamesYouTube

Properties

Name	Type	Description
id	string	Unique identifier for the review.
url	string
title	string
mediaType	string
langcode	string
ageRating	integer	Recommended minimum age.
ageRatingGroup	string
stars	integer	Star rating out of five.
oneLiner	string
anyGood	string
parentsNeedToKnow	string
description	string
talkingPoints	array
contentGrid	object	Per-criterion content ratings.
updated	integer	Unix timestamp of last update.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/common-sense-media/refs/heads/main/json-schema/common-sense-media-review-schema.json",
  "title": "Common Sense Media Review",
  "description": "Schema for a single review returned from the Common Sense Media Reviews API v3.",
  "type": "object",
  "required": ["id", "mediaType", "title"],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "Unique identifier for the review."
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "title": {
      "type": "string"
    },
    "mediaType": {
      "type": "string",
      "enum": ["app", "book", "game", "movie", "podcast", "tv", "website", "youtube"]
    },
    "langcode": {
      "type": "string",
      "enum": ["en", "es"],
      "default": "en"
    },
    "ageRating": {
      "type": "integer",
      "minimum": 2,
      "maximum": 18,
      "description": "Recommended minimum age."
    },
    "ageRatingGroup": {
      "type": "string",
      "enum": ["littleKids", "kids", "tweens", "teens"]
    },
    "stars": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Star rating out of five."
    },
    "oneLiner": {
      "type": "string"
    },
    "anyGood": {
      "type": "string"
    },
    "parentsNeedToKnow": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "talkingPoints": {
      "type": "array",
      "items": { "type": "string" }
    },
    "contentGrid": {
      "type": "object",
      "description": "Per-criterion content ratings.",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "rating": { "type": "integer", "minimum": 0, "maximum": 5 },
          "label": { "type": "string" },
          "text": { "type": "string" }
        }
      }
    },
    "updated": {
      "type": "integer",
      "description": "Unix timestamp of last update."
    }
  }
}