Video

A video as represented in the Family Graph API.

A family site can include media items such as photos, documents, videos, and audios. Individuals and events in the family tree can be associated to videos and other media items using tags. A video contains a file that is accessible via a url. Videos and other media items can be organized in albums in the family site.


Fields

The Video object contains the following fields:

Name Description Type Access Mode

id

The video's id

id

read

type

The media item type

string

read

name

The video's name (title)

string

read, write

date

When the video was taken

EventDate object: gedcom, text, date, structured_date and class_name fields

read, write

place

Where the video was taken

string

read, write

description

The video's description

string

read, write

link

Link to video on MyHeritage.com

string

read

url

The url for the video

string

read

thumbnails

List of different thumbnails of different sizes for the video

array of Image objects containing the url, width, height and class_name fields

read

width

The width of the video in pixels

int

read

height

The height of the video in pixels

int

read

extension

The extension of the video's file name

string

read

duration

The duration of the video (HH:MM:SS)

string

read

submitter

The user who submitted the video to the site

User object: id and name fields

read

created_time

The time when the video was submitted to the site

string (YYYY-MM-DD HH:MM:SS)

read

updated_time

The date and time when the video was last updated on the site

string (YYYY-MM-DD HH:MM:SS)

read

site

The site of the video

Site object: id and name fields

read

source

Id of the video file part in format 'cid:<filename>'

string

write

class_name

The object class name

string

read

Connections

The Video object contains the following connections:
Name Description Type Access Mode

keywords

Keywords associated with the video

array of strings

read

items

List of objects that are associated with the video (individuals, families, events, family events and sources)

array of TreeItem objects

read

albums

List of albums the video is in

array of Album objects

read

tags

List of tags of individuals in the video

array of Tag objects

read

comments

List of comments associated with the video

array of Comment objects

read

Example

https://familygraph.myheritage.com/video-144530322-1-1000394 (open in browser)
{
"id": "video-144530322-1-1000394",
"type": "video",
"name": "JFKatRice",
"link": "https:\/\/www.myheritage.com\/video-1000394_144530322_144530322\/jfkatrice",
"url": "https:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/03\/94\/000394_7468270bb32w7fd68bn824.flv",
"thumbnails": [
{
"url": "https:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/03\/94\/000394_85223626w3vb24g3vb7fdp.jpg",
"width": 160,
"height": 120,
"class_name": "Image"
},
{
"url": "https:\/\/thumbnail.myheritageimages.com\/530\/322\/144530322\/000\/000394_85223626w3vb24g3vb7fdp_D_40x30.jpg",
"width": 40,
"height": 30,
"class_name": "Image"
}
],
"width": 160,
"height": 120,
"extension": "flv",
"duration": "00:00:08",
"submitter": {
"id": "user-10",
"name": "Developer MyHeritage"
},
"created_time": "2011-03-03T16:01:01+0000",
"updated_time": "2011-03-03T16:01:01+0000",
"site": {
"id": "site-144530322",
"name": "Demo Family Site"
},
"class_name": "Video"
}