MediaItem

A media item as represented in the Family Graph API.

A family site can include media items such as photos, documents, video, audios.Individuals and events in the family tree can be associated to media items using tags. Media items contain a url to the item and may also contain several thumbnails images in several different sizes. Media items can be organized in albums in the family site.


Fields

The MediaItem object contains the following fields:

Name Description Type Access Mode

id

The media item's id

id

read

type

The media item type

string

read

name

The media item's name (title)

string

read

date

The media item's date, for example, when a photo was taken

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

read

place

The media item's place, for example, where a photo was taken

string

read

description

The media item's description

string

read

link

Link to media item on MyHeritage.com

string

read

url

The url for the media item

string

read

thumbnails

List of different thumbnails of different sizes for the media item

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

read

extension

The extension of the media item's file name

string

read

submitter

The user who submitted the media item to the site

User object: id and name fields

read

created_time

The time when the media item was submitted to the site

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

read

updated_time

The date and time when the media item was last updated on the site

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

read

site

The site of the media item

Site object: id and name fields

read

class_name

The object class name

string

read

Connections

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

keywords

Keywords associated with the media item

array of strings

read

items

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

array of TreeItem objects

read

albums

List of albums the media item is in

array of Album objects

read

tags

List of tags of individuals in the media item

array of Tag objects

read

comments

List of comments associated with the media item

array of Comment objects

read

Examples

Photo

https://familygraph.myheritage.com/photo-144530322-1-1000007 (open in browser)
{
"id": "photo-144530322-1-1000007",
"type": "photo",
"name": "John Jr. plays under the desk of his fatherm JFK.",
"date": {
"gedcom": "Jan 1 1963",
"text": "Jan 1 1963",
"date": "1963-01-01",
"structured_date": {
"first_date": {
"day": 1,
"month": 1,
"year": 1963,
"type": "exact",
"class_name": "SingleDate"
},
"type": "exact",
"class_name": "StructuredDate"
},
"class_name": "EventDate"
},
"link": "https:\/\/www.myheritage.com\/photo-1000007_144530322_144530322\/john-jr-plays-under-the-desk-of-his-fatherm-jfk",
"url": "https:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/00\/07\/000007_83785454f22ubo2b4d6bdd.jpg",
"thumbnails": [
{
"url": "https:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/00\/07\/000007_83785454f22ubo2b4d6bdd.jpg",
"width": 473,
"height": 600,
"class_name": "Image"
},
{
"url": "https:\/\/thumbnail.myheritageimages.com\/530\/322\/144530322\/000\/000007_83785454f22ubo2b4d6bdd_D_202x256.jpg",
"width": 202,
"height": 256,
"class_name": "Image"
},
{
"url": "https:\/\/thumbnail.myheritageimages.com\/530\/322\/144530322\/000\/000007_83785454f22ubo2b4d6bdd_D_32x40.jpg",
"width": 32,
"height": 40,
"class_name": "Image"
}
],
"width": 473,
"height": 600,
"extension": "jpg",
"has_reverse_side": false,
"submitter": {
"id": "user-10",
"name": "Developer MyHeritage"
},
"created_time": "2011-03-03T16:01:11+0000",
"updated_time": "2011-03-03T16:01:11+0000",
"is_personal_photo": false,
"site": {
"id": "site-144530322",
"name": "Demo Family Site"
},
"class_name": "Photo"
}

Video

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

Document

https://familygraph.myheritage.com/document-144530322-1-1000009 (open in browser)
{
"id": "document-144530322-1-1000009",
"type": "document",
"name": "JFKs Moon Speech",
"date": {
"gedcom": "Sep 12 1962",
"text": "Sep 12 1962",
"date": "1962-09-12",
"structured_date": {
"first_date": {
"day": 12,
"month": 9,
"year": 1962,
"type": "exact",
"class_name": "SingleDate"
},
"type": "exact",
"class_name": "StructuredDate"
},
"class_name": "EventDate"
},
"link": "https:\/\/www.myheritage.com\/document-1000009_144530322_144530322\/jfks-moon-speech",
"url": "https:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/00\/09\/000009_4614646pof4gd42b425bgv.doc",
"thumbnails": [
{
"url": "https:\/\/www.myheritageimages.com\/Z\/storage\/site144530322\/files\/00\/00\/09\/000009_31572441dy19c5b7f7l6p6.jpg",
"width": 111,
"height": 142,
"class_name": "Image"
},
{
"url": "https:\/\/thumbnail.myheritageimages.com\/530\/322\/144530322\/000\/000009_31572441dy19c5b7f7l6p6_Z_31x40.jpg",
"width": 31,
"height": 40,
"class_name": "Image"
}
],
"extension": "doc",
"submitter": {
"id": "user-10",
"name": "Developer MyHeritage"
},
"created_time": "2011-03-03T16:01:15+0000",
"updated_time": "2011-03-03T16:01:15+0000",
"site": {
"id": "site-144530322",
"name": "Demo Family Site"
},
"class_name": "Document"
}
https://familygraph.myheritage.com/audio-144530322-1-1 (open in browser)
{
"id": "audio-144530322-1-1",
"type": "audio",
"name": "asknot",
"link": "https:\/\/www.myheritage.com\/audio-1_144530322_144530322\/asknot",
"url": "https:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/00\/01\/000001_014600em83i3l5d462ce4u.mp3",
"extension": "mp3",
"duration": "00:00:10",
"submitter": {
"id": "user-10",
"name": "Developer MyHeritage"
},
"created_time": "2011-08-23T15:10:33+0000",
"updated_time": "2011-08-23T15:10:33+0000",
"site": {
"id": "site-144530322",
"name": "Demo Family Site"
},
"class_name": "Audio"
}