Recommendation Lists

The channel for this Recommendation List.
Allowed values: movie, game, tv, app, book, website.

Example:

channel: [
"movie"
]

A short description of this Recommendation List.

Example:

summary: "Description of list."

The URL to the Recommendation List on Common Sense Media's website.

Example:

url: "http://www.commonsensemedia.org/lists/url-to-recommended-list-title"

Common Sense Media's universal unique identifier for the Recommendation List.

Example:

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

Date and time when the Recommendation List was last updated. Timestamp in UTC format.

Example:

updated: 1409095369

Title of the Recommended List.  Max 255 characters.

Example:

title: "Title of the Recommended List"

Date and time when the Recommendation List was published. Timestamp in UTC format.

Example:

created: 1409003520

Contains the recommended list author. Fixed value: Common Sense Media.

Example:

author: "Common Sense Media"

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

title

The title of this item.

id

Common Sense Media's unique ID for this item.

uuid

Common Sense Media's universal unique identifier for this item.

url (optional)

The URL to the item on Common Sense Media's website.

summary (optional)

A short description of the item.

ageRating (optional)

The age rating for the review. This field replaces Common Sense slider fieldset.

Example:

reviews: [
{
title: "The title of this item",
id: 1234567,
uuid: "140fd905-17ff-4154-9405-c309085afb80",
url: "http://www.commonsensemedia.org/url-to-title",
summary: "A short description of the item.",
ageRating: 10
}
]

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

title

The title of this item.

id

Common Sense Media's unique ID for this item.

uuid

Common Sense Media's universal unique identifier for this item.

url (optional)

The URL to the item on Common Sense Media's website.

summary (optional)

A short description of the item.

Example:

otherPicks: [
{
title: "The title of this item",
id: 1234567,
uuid: "140fd905-17ff-4154-9405-c309085afb80",
url: "http://www.commonsensemedia.org/url-to-title",
summary: "A short description of item"
}
]

Introductory text describing the Recommendation List and its purpose.

Example:

intro: "Introductory text"

The type of category for this Recommendation List. Matches the value in channel.

Each category includes Common Sense Media's unique ID for this category. Allows cross-referencing of content. Allowed values: Movies, Games, TV, Apps, Books, Websites, Best for Learning, Best for Character Development.

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:

categories: {
140fd905-17ff-4154-9405-c309085afb80: "Movies"
}

categories: {
23926: "Movies"
}

Age range of items in the list.

min attribute

Minimum age recommended for the items in this list. Allowed values: 1-17.

max attribute

Maximum age recommended for the items in this list. Allowed values: 1-17.

Example:

ages: {
min: 5,
max: 13
}