Reviews

Reviews

IMPORTANT NOTE: We are transitioning over our unique identifiers to using UUIDs from IDs. Please store both ids to future-proof your data.

Element Description
channel Type of product being reviewed.

Allowed values: movie, game, tv, app, book, website



Example:

channel: "type of product"
ageRating The age rating for the review. Possible values: 2-18. Integer.



NOTE: This age field replaces Common Sense slider fieldset.



Example:

ageRating: 13
ageRatingGroup The age group assigned based on age rating for the review. Possible values: null, Preschoolers, Little Kids, Big Kids, Tweens, and Teens.

Example:

ageRatingGroup: "Tweens"
url Unique web location for the review.



Example:

url: "https://www.commonsensemedia.org/path-to-review"
id Common Sense Media's unique ID for the review.



Example:

id: 1234567
uuid Universal unique identifier.



Example:

uuid: "140fd905-17ff-4154-9405-c309085afb80"
updated Timestamp when the review was last updated, in UTC format.



Example:

updated: 1407030001
title Title of the product being reviewed. String, max 255 characters.



Example:

title: "Title of Review"
created Timestamp when the review was published, in UTC format.



Example:

created: 1400628360
author Contains a single element of the review author.



Example:

author: "Common Sense Media Reviewer's name"
video

(optional)		 Information about a video available from Common Sense Media. If there is a video review associated with this item, this will be filled.

NOTE: The following formats (flash, html5_ff, mobile_ff, html5_ig, mobile_ig, prores_ig) are currently in the feed but will be discontinued in Aug 2021

files attribute
Collection of file formats available for this video. Array.
lang
Language of video file. Possible values: en
type
Format of video file. Possible values: html5, mobile, prores, flash*, html5_ff*, mobile_ff*, html5_ig*, mobile_ig*, prores_ig*

* see NOTE above.

uri
URL to video file.
thumbnail attribute
Single screenshot of the video. The attributes are:
small
URL to small image of screenshot.
large
URL to large image of screenshot.





Example:

video: {

files: [

{

lang: "en",

type: "html5",

uri: "path-to-video.mp4"

},

{

lang: "en",

type: "mobile",

uri: "path-to-video-mobile.mp4"

},

{

lang: "en",

type: "prores",

uri: "path-to-video.mov"

}

}
themes Common Sense Media assigned themes or topics. Contains unlimited theme elements.



Each theme includes Common Sense Media's unique ID for this theme. Allows cross-referencing of content.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

themes: {

140fd905-17ff-4154-9405-c309085afb80: "A type of theme for this title."

}


themes: {

12345: "A type of theme for this title."

}
talkingPoints Families Can Talk About (Explore, Discuss, Enjoy) content. Array. Contains up to 5 items.



Example:

talkingPoints: [

"String 1",

"String 2",

"String 3"

]
stars Common Sense Media's star rating of this title. Allowed values: 1-5.



Example:

stars: 4
product Contain fields for the product details. See product documentation for channel specific fields.
parentsNeedToKnow Parents Need to Know text. String.



Example:

parentsNeedToKnow: "String"
oneLiner Common Sense Media one-liner. String.



Example:

oneLiner: "String"
description Plot summary. This corresponds to the ‘What’s the story?’ (Movies, Book, TV) or 'What's it about?' (Apps, Games, Websites) text on the Common Sense Media website. String.



Example:

description: "String"
contentGrid Only content grid items relevant to the title. All items must be displayed, in the order presented in our style guide (also the order used on our website).



Each content grid item contain these attributes:
rating attribute
The amount of the content grid item in the title. Allowed values: 0-5
text attribute
Explanation of the rating for the content grid item. Text must be used exactly as presented.
label attribute
Display name of the content grid item (e.g. Violence). This may be different for titles targeted at ages 8 and below versus 9+; use the text on a per-title basis.





Example:

contentGrid: {

consumerism: {

rating: 4,

text: "String",

label: "Consumerism"

},

drugs: {

rating: 0,

text: "String",

label: "Drinking, drugs, & smoking"

}, ...

characterStrengths Common Sense Media assigned character strengths. Contains 0 to unlimited items.



Allowed values: null, Communication, Compassion, Courage, Curiosity, Empathy, Gratitude, Humility, Integrity, Perseverance, Self-control, Teamwork



Each character strength includes Common Sense Media's unique ID for this item.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

characterStrengths: {

140fd905-17ff-4154-9405-c309085afb80: "A character strength",

}

characterStrengths: {

12345: "A character strength",

}
positiveGender Common Sense Media identified reviews that stand out for Positive Gender Representations.



Allowed values: null, true


Example:

positiveGender: true
anyGood Is It Any Good? content. String.



Example:

anyGood: "String"
alternatives Other choices (titles) for this title. These are always titles that have been reviewed by Common Sense Media.



Array. Contains up to 10 items. Each item contains the following attributes:
title attribute
Title of alternative product
id attribute
Unique ID for alternative product review
uuid attribute
Universal unique identifier for alternative product review
url attribute
URL to alternative product review



Example:

alternatives: [

{

title: "A title",

id: 123456,

uuid: "140fd905-17ff-4154-9405-c309085afb80",

url: "http://www.commonsensemedia.org/path-to-review"

} ]
stats
 Information about user review stats for a review (Parents say/Kids say).

Allowed values: null

recommended_age attribute
Average age based on user reviews.
avg
adult: Average age from Adult user reviews
child: Average age from Child user reviews
stars attribute
Average stars based on user reviews.
avg
adult: Average star rating from Adult user reviews
child: Average star rating from Child user reviews
user_review_count attribute
Count of user reviews.
count
adult: Count of Adult user reviews
child: Count of Child user reviews





Example:


stats: {
recommended_age: {
avg: {
adult: 13.1667,
child: 13.875
}
},
stars: {
avg: {
adult: 2.375,
child: 3.42424
}
},
user_review_count: {
count: {
adult: 24,
child: 33
}
}
}
reviewTopPicks These are Recommended lists that refer to this review.



Array. Allowed values: null. Each item contains the following attributes:
title attribute
Title of Recommended list
id attribute
Unique ID for Recommended list
uuid attribute
Universal unique identifier for Recommended list



Example:


reviewTopPicks: [
{
title: "Best Original Movies",
uuid: "140fd905-17ff-4154-9405-c309085afb80",
id: 1234567
}
]

Product

The fields within product are based on the product type or channel.

Movies

Element Description
id Common Sense Media's unique ID for the product.



Example:

id: 1234567
uuid Universal unique identifier.



Example:

uuid: "140fd905-17ff-4154-9405-c309085afb80"
references Contains unlimited reference items. Array. Each item contains the following attributes:
type
The provider of the reference. Allowed values: upc, itunes, googleplay, asinproduct, asinstream.
value
A third-party unique ID to help in title matching.



Example:

references: [

{

type: "provider",

value: "70301645"

}

]
images Product images. Contains unlimited image items. Array. Each item contains the following attributes:
type
Type of image. Allowed values: product, screenshot.
url
Path to image.





Example:

images: [

{

type: "product",

url: "https://url-to-product-image"

},

{

type: "screenshot",

url: "https://url-to-screenshot"

} ]
awards

Contains zero to unlimited award elements. Each award contains the Common Sense Media's unique ID for this award.  Allows cross-referencing of content by award. 

The Common Sense Seal would be listed in this data.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

awards: {

140fd905-17ff-4154-9405-c309085afb80: "A type of award for this title."

}




awards: {

1234: "A type of award for this title."

}

releaseDates Contains unlimited releaseDate items. Array. Each item contains the following attributes:
type
Allowed values: theaters, dvd.
date
Timestamp when the item was released, in UTC format.



Example:

releaseDates: [

{

type: "theaters",

date: "1406851200"

}

]
rating The MPAA rating and reason for that rating (e.g., “PG-13 for mild violence and sexual innuendo”). This must be used exactly as shown.
type attribute
Fixed value: mpaa
value attribute
The actual rating. Allows cross-referencing by rating. Allowed values: G, PG, PG-13, R, NR, NC-17.
explanation
Rating explanation. String.
text
Combines value and explanation





Example:

rating: {

type: "mpaa",

value: "PG-13",

explanation: "String",

text: "PG-13 for String"

}
studios

The movie studio(s) that released this title.



Contains unlimited items.



Each item includes Common Sense Media's unique ID for this studio.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

studios: {

140fd905-17ff-4154-9405-c309085afb80: "A studio for this title."

}



studios: {

1234: "A studio for this title."

}
length This movie's length. The attributes are:
units attribute
Fixed value: minutes
value attribute
Length in whole minutes



Example:

length: {

units: "minutes",

value: "122"

}
genres The title's genre, as assigned by Common Sense Media.



Each genre entry includes the Common Sense Media's unique ID for this genre.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

genres: {

140fd905-17ff-4154-9405-c309085afb80: "A genre for this title."

}



genres: {

1234: "A genre for this title."

}

directors The director(s) of this title. All names must be displayed, in the order listed.



Contains up to 5 items.



Each director entry includes the Common Sense Media's unique ID for the director member.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

directors: {

140fd905-17ff-4154-9405-c309085afb80: "A director for this title."

}



directors: {

1234: "A director for this title."

}

cast Main cast of this title. All names must be displayed, in the order listed.



Contains up to 5 items.



Each cast name entry includes the Common Sense Media's unique ID for the cast member.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

cast: {

140fd905-17ff-4154-9405-c309085afb80: "A cast name for this title."

}



cast: {

1234: "A cast name for this title."

}

Games

Element Description
id Common Sense Media's unique ID for the product.



Example:

id: 1234567
uuid Universal unique identifier.



Example:

uuid: "140fd905-17ff-4154-9405-c309085afb80"
references Contains unlimited reference items. Array. Each item contains the following attributes:
type
The provider of the reference. Allowed values: upc, netflix, itunes, googleplay, asinproduct, asinstream.
value
A third-party unique ID to help in title matching.



Example:

references: [

{

type: "provider",

value: "70301645"

}

]
genres The title's genre, as assigned by Common Sense Media.



Each genre entry includes the Common Sense Media's unique ID for this genre.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

genres: {

140fd905-17ff-4154-9405-c309085afb80: "A genre for this title."

}



genres: {

1234: "A genre for this title."

}

images Product images. Contains unlimited image items. Array. Each item contains the following attributes:
type
Type of image. Allowed values: product, screenshot.
url
Path to image.





Example:

images: [

{

type: "product",

url: "https://url-to-product-image"

},

{

type: "screenshot",

url: "https://url-to-screenshot"

} ]
awards

Contains zero to unlimited award elements. Each award contains the Common Sense Media's unique ID for this award. Allows cross-referencing of content by award.

The Common Sense Seal would be listed in this data.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

awards: {

140fd905-17ff-4154-9405-c309085afb80: "A type of award for this title. "

}

awards: {

1234: "A type of award for this title. "

}
releaseDate Timestamp when the item was released, in UTC format. Contains a single date element.



Example:

releaseDate: 1163923200
developers

The game developer(s) that released this title.



Contains unlimited items.



Each item includes Common Sense Media's unique ID for this developer.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

developers: {

140fd905-17ff-4154-9405-c309085afb80: "A game developer for this title."

}



developers: {

1234: "A game developer for this title."

}
priceStructure

The pricing structure for the game.



Allowed values: Free, Free to Try and Paid



Each item includes Common Sense Media's unique ID.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

priceStructure: {

140fd905-17ff-4154-9405-c309085afb80: "A price structure for this title."

}



priceStructure: {

1234: "A price structure for this title."

}
prices The cost to purchase this game. Can be empty or show up to two attributes:
purchase attribute
Pricing information for title. String.
subscription attribute
Subscription information for title. String.

Example:

prices: {

purchase: "Free, with in-game purchases",

subscription: "$60/year (optional)"

}
platforms Contains unlimited platform items. Each item contains Common Sense Media's unique ID for the platform. Each platform contains these attributes:
name attribute
A platform this game is available on (e.g. Xbox 360).
rating attribute
The rating information for the title, one per platform. Contains these attributes:
type
Fixed value: esrb
value
The actual rating. Allows cross-referencing by rating. Allowed values: AO, E, E10+, EC, M, NR, RP, T.
explanation
The ESRB rating description/reason for that rating (e.g. animated violence and language). This must be used exactly as shown. Note that different platforms could have different ESRB ratings. String





NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

platforms: {

140fd905-17ff-4154-9405-c309085afb80: {

name: "Platform Name",

rating: {

type: "esrb",

value: "E",

explanation: "Rating description"

}

}

}

platforms: {

1234: {

name: "Platform Name",

rating: {

type: "esrb",

value: "E",

explanation: "Rating description"

}

}

}

Apps

Element Description
id Common Sense Media's unique ID for the product.



Example:

id: 1234567
uuid Universal unique identifier.



Example:

uuid: "140fd905-17ff-4154-9405-c309085afb80"
references Contains unlimited reference items. Array. Each item contains the following attributes:
type
The provider of the reference. Allowed values: upc, netflix, itunes, googleplay, asinproduct, asinstream.
value
A third-party unique ID to help in title matching.



Example:

references: [

{

type: "provider",

value: "70301645"

}

]
genres The title's genre, as assigned by Common Sense Media.



Each genre entry includes the Common Sense Media's unique ID for this genre.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

genres: {

140fd905-17ff-4154-9405-c309085afb80: "A genre for this title."

}



genres: {

1234: "A genre for this title."

}
images Product images. Contains unlimited image items. Array. Each item contains the following attributes:
type
Type of image. Allowed values: product, screenshot.
url
Path to image.





Example:

images: [

{

type: "product",

url: "https://url-to-product-image"

},

{

type: "screenshot",

url: "https://url-to-screenshot"

} ]
awards

Contains zero to unlimited award elements. Each award contains the Common Sense Media's unique ID for this award. Allows cross-referencing of content by award.

The Common Sense Seal would be listed in this data.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

awards: {

140fd905-17ff-4154-9405-c309085afb80: "A type of award for this title. "

}



awards: {

1234: "A type of award for this title. "

}
version Version number of this app (e.g. 1.02, 2.0). String.



Example:

version: "2.3.2"
size

The app download size in megabytes (MB).

units attribute
Fixed value: MB.
value attribute
Download size of the app. String



Example:

size: {

units: "MB",

value: "38.70"

}
requirements Required operating system (OS) for this app (e.g. iOS 5.0 or later). String.



Example:

requirements: "4.3 or later"
releaseDate Timestamp when the item was released, in UTC format. Contains a single date element.



Example:

releaseDate: 1163923200
developers

The app developer(s) that released this title.



Contains unlimited items.



Each item includes Common Sense Media's unique ID for this developer.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

developers: {

140fd905-17ff-4154-9405-c309085afb80: "An app developer for this title."

}



developers: {

1234: "An app developer for this title."

}
priceStructure

The pricing structure for the game.



Allowed values: null, Free, Free to Try and Paid



Each item includes Common Sense Media's unique ID.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

priceStructure: {

140fd905-17ff-4154-9405-c309085afb80: "A price structure for this title."

}



priceStructure: {

1234: "A price structure for this title."

}
prices The cost to purchase this app. Can be empty or show up to two attributes:
purchase attribute
Pricing information for title. String.
subscription attribute
Subscription information for title. String.

Example:

prices: {

purchase: "Free, with in-app purchases",

subscription: "$60/year (optional)"

}
platforms A platform/device that this app is available on (e.g. iPhone, iPad, Android, Kindle Fire). Contains unlimited platform elements.



Each platform includes Common Sense Media's unique ID for this theme. Allows cross-referencing of content.


NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

platforms: {

140fd905-17ff-4154-9405-c309085afb80: "A platform for this title."

}

platforms: {

12345: "A platform for this title."

}

Websites

Element Description
id Common Sense Media's unique ID for the product.



Example:

id: 1234567
uuid Universal unique identifier.



Example:

uuid: "140fd905-17ff-4154-9405-c309085afb80"
releaseDate Timestamp when the item was released, in UTC format. Contains a single date element.



Example:

releaseDate: 1163923200
genres The title's genre, as assigned by Common Sense Media.



Each genre entry includes the Common Sense Media's unique ID for this genre.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

genres: {

140fd905-17ff-4154-9405-c309085afb80: "A genre for this title."

}



genres: {

1234: "A genre for this title."

}

images Product images. Contains unlimited image items. Array. Each item contains the following attributes:
type
Type of image. Allowed values: product, screenshot.
url
Path to image.





Example:

images: [

{

type: "product",

url: "https://url-to-product-image"

},

{

type: "screenshot",

url: "https://url-to-screenshot"

} ]
awards

Contains zero to unlimited award elements. Each award contains the Common Sense Media's unique ID for this award. Allows cross-referencing of content by award.

The Common Sense Seal would be listed in this data.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

awards: {

140fd905-17ff-4154-9405-c309085afb80: "A type of award for this title. Example: Webby"

}

awards: {

1234: "A type of award for this title. Example: Webby"

}
url The website's address (URL).

Example:

url: "http://website-address"
priceStructure

The pricing structure for the game.



Allowed values: null, Free, Free to Try and Paid



Each item includes Common Sense Media's unique ID.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

priceStructure: {

140fd905-17ff-4154-9405-c309085afb80: "A price structure for this title."

}



priceStructure: {

1234: "A price structure for this title."

}

TV Shows

Element Description
id Common Sense Media's unique ID for the product.



Example:

id: 1234567
uuid Universal unique identifier.



Example:

uuid: "140fd905-17ff-4154-9405-c309085afb80"
releaseDate Timestamp when the item was released, in UTC format. Contains a single date element.



Example:

releaseDate: 1163923200
references Contains unlimited reference items. Array. Each item contains the following attributes:
type
The provider of the reference. Allowed values: upc, netflix, itunes, googleplay, asinproduct, asinstream.
value
A third-party unique ID to help in title matching.



Example:

references: [

{

type: "provider",

value: "70301645"

}

]
genres The title's genre, as assigned by Common Sense Media.



Each genre entry includes the Common Sense Media's unique ID for this genre.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

genres: {

140fd905-17ff-4154-9405-c309085afb80: "A genre for this title."

}



genres: {

1234: "A genre for this title."

}
images Product images. Contains unlimited image items. Array. Each item contains the following attributes:
type
Type of image. Allowed values: product, screenshot.
url
Path to image.





Example:

images: [

{

type: "product",

url: "https://url-to-product-image"

},

{

type: "screenshot",

url: "https://url-to-screenshot"

} ]
awards

Contains zero to unlimited award elements. Each award contains the Common Sense Media's unique ID for this award. Allows cross-referencing of content by award.

The Common Sense Seal would be listed in this data.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

awards: {

140fd905-17ff-4154-9405-c309085afb80: "A type of award for this title. Example: Emmy, Golden Globe"

}

awards: {

1234: "A type of award for this title. Example: Emmy, Golden Globe"

}
rating

The TV Parental Guidelines rating and reason for that rating (e.g., “TV-14 for strong language and drug use”). This must be used exactly as shown.

type attribute
Fixed value: tv
value attribute
The actual rating. Allows cross-referencing by rating. Allowed values: NR, TV-G, TV-Y, TV-Y7, TV-Y7-FV, TV-PG, TV-14, TV-MA.
explanation
Rating explanation. String.





Example:

rating: {

type: "tv",

value: "TV-PG",

explanation: "Rating explanation." }
platforms A platform this TV show is available on (e.g. DVD, Streaming). String. Contains unlimited platform elements.



Each platform includes Common Sense Media's unique ID for this platform. Allows cross-referencing of content.


NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

platforms: {

140fd905-17ff-4154-9405-c309085afb80: "A platform for this title."

}

platforms: {

12345: "A platform for this title."

}
networks

The network(s) that produced this title.



Contains unlimited items.



Each item includes Common Sense Media's unique ID for this network.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

networks: {

140fd905-17ff-4154-9405-c309085afb80: "A network for this title."

}



networks: {

1234: "A network for this title."

}
cast Main cast of this title. All names must be displayed, in the order listed.



Contains up to 5 items.



Each cast name entry includes the Common Sense Media's unique ID for the cast member.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

cast: {

140fd905-17ff-4154-9405-c309085afb80: "A cast name for this title."

}



cast: {

1234: "A cast name for this title."

}

Books

Element Description
id Common Sense Media's unique ID for the product.



Example:

id: 1234567
uuid Universal unique identifier.



Example:

uuid: "140fd905-17ff-4154-9405-c309085afb80"
references Contains unlimited reference items. Array. Each item contains the following attributes:
type
The provider of the reference. Allowed values: upc, netflix, itunes, googleplay, asinproduct, asinstream.
value
A third-party unique ID to help in title matching.



Example:

references: [

{

type: "provider",

value: "70301645"

}

]
genres The title's genre, as assigned by Common Sense Media.



Each genre entry includes the Common Sense Media's unique ID for this genre.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

genres: {

140fd905-17ff-4154-9405-c309085afb80: "A genre for this title."

}



genres: {

1234: "A genre for this title."

}
images Product images. Contains unlimited image items. Array. Each item contains the following attributes:
type
Type of image. Allowed values: product, screenshot.
url
Path to image.





Example:

images: [

{

type: "product",

url: "https://url-to-product-image"

},

{

type: "screenshot",

url: "https://url-to-screenshot"

} ]
awards

Contains zero to unlimited award elements. Each award contains the Common Sense Media's unique ID for this award. Allows cross-referencing of content by award.

The Common Sense Seal would be listed in this data.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

awards: {

140fd905-17ff-4154-9405-c309085afb80: "A type of award for this title. Example: Caldecott Medal, Newbery Medal."

}

awards: {

1234: "A type of award for this title. Example: Caldecott Medal, Newbery Medal."

}
types The type of book, Fiction or Non-Fiction. Each type contains the Common Sense Media's unique ID for this book type. Allows cross-referencing of content by type.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

types: {

140fd905-17ff-4154-9405-c309085afb80: "A book type for this title."

}

types: {

1234: "A book type for this title."

}
releaseDate Timestamp when the item was released, in UTC format. Contains a single date element.



Example:

releaseDate: 1163923200
readingLevels Contains up to three reading level elements.
type attribute
The type of reading level age range. Allowed values: publisher, read_aloud, read_aloud.
from attribute
The younger age of this range. Value will be a single age. Integer, 0-18.
to attribute
The older age of this range. Value will be a single age. Integer, 0-18.





Example:

readingLevels: [

{

type: "publisher",

from: "8",

to: "12"

}

]
publishers

The publisher(s) that released this title.



Contains unlimited items.



Each item includes Common Sense Media's unique ID for this publisher.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

publishers: {

140fd905-17ff-4154-9405-c309085afb80: "A publisher for this title."

}



publishers: {

1234: "A publisher for this title."

}
pages The number of pages in the book, in whole pages.



Example:

pages: "192"
illustrators The illustrator(s) of this book. All names must be displayed, in the order listed.



Contains up to 5 elements.



Each item includes Common Sense Media's unique ID for this illustrator.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

illustrators: {

140fd905-17ff-4154-9405-c309085afb80: "An illustrator for this title."

}



illustrators: {

1234: "An illustrator for this title."

}

 
formats A format this book is available on (e.g. Hardback, iBooks, Kindle, Nook). String. Contains unlimited platform elements.



Each format includes Common Sense Media's unique ID for this format. Allows cross-referencing of content.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

formats: {

140fd905-17ff-4154-9405-c309085afb80: "A format for this title."

}

formats: {

12345: "A format for this title."

}
authors The author(s) of this book. All names must be displayed, in the order listed.



Contains up to 5 elements.



Each item includes Common Sense Media's unique ID for this author.



NOTE: We are transitioning to using UUIDs as identifiers. Depending on when an API Key is generated, this output may display differently. Please store these identifiers as alphanumeric.

Possible output:

authors: {

140fd905-17ff-4154-9405-c309085afb80: "An author for this title."

}



authors: {

1234: "An author for this title."

}