Videos

channel

The channel represented in this video.
Allowed values: movie, game, tv, app, book, website.

Example:

channel: [
"movie"
]

summary

A short description of this video.

Example:

summary: "Short description of the video."

url

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

Example:

url: "https://www.commonsensemedia.org/lists/url-to-video"

uuid

Universal unique identifier.

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

parentIDs

Common Sense Media's editorial review unique ID for the corresponding Movie video review. Array (usually no more than one).

Example:

parentIDs: [
"5000546"
]

parentUUIDs

Common Sense Media's editorial review universal unique ID for the corresponding Movie video review. Array (usually no more than one).

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

updated

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

Example:

updated: 1409095369

title

Video title.   String, max 255 characters.

Example:

title: "Title of the video"

created

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

Example:

created: 1409003520

author

Contains the video author. Fixed value: Common Sense Media.

Example:

author: "Common Sense Media"

types

The type of video. Allowed values: advice, review, about us, interviews, top picks

Example:

types: [
"review"
]

topics

The topic/category of the video. Unlimited items.

Example:

topics: [
"topic name"
]

thumbnail

URL to image files on Common Sense Media's servers. Please download all images; hotlinking is not allowed.

small

URL to small thumbnail image

large

URL to large image

Example:

thumbnail: {
small: "http://url-to-small-image",
large: "http://url-to-large-image"
}

length

An integer that represents the running time of the video in seconds (e.g. 120 = 120 seconds = 2 minutes).

Example:

length: 90

genres

The genre represented in this video. String. Unlimited.

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: "Comedy"
} 

genres: {
4528: "Comedy"
}

files

Information about the video file(s). 

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

type

Allowed values: html5, mobile, prores, flash*, html5_ff*, mobile_ff*, html5_ig*, mobile_ig*, prores_ig*

uri

URL to file.

Example:

files: [
{
type: "html5_ff",
uri: "path-to-file.mp4"
}
]

subtitles

Subtitle information for the video file(s).

lang

Allowed values: null, en

uri

URL to vtt file.

Example:

subtitles: [
{
lang: "en",
uri: "path-to-file.vtt"
}
]

ages

Age range intended for the video.

min attribute

Minimum age to which this video applies. Allowed values: 1-17.

max attribute

Maximum age to which this video applies. Allowed values: 1-17.

Example:

ages: {
min: 5,
max: 13
}

topPicks

Titles referenced in "top picks" video.

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

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

Example:

topPicks: [ { title: "title of item", id: 1234567, uuid: "140fd905-17ff-4154-9405-c309085afb80", url: "url to title" }, ... ]