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
source	The media item’s place in cloud or not	string	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:\/\/sites-cf.mhcache.com\/e\/1\/WC1BbXotQ29udGVudC1TaGEyNTY9VU5TSUdORUQtUEFZTE9BRCZYLUFtei1DcmVkZW50aWFsPUFLSUFYRDZIUllIRUlUVzRHV0VCJTJGMjAyMjA2MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjIwNjI3VDA2MDAwMFomWC1BbXotRXhwaXJlcz02MDQ4MDAmWC1BbXotU2lnbmF0dXJlPWY1ZjE0YzY1MDk2MzM0NDlhNzY4ZmE0OGU2NGMwOTIwOTI0MmMwYTE5NTk4NjRmMmE4NTI0ZTU5MmEzNjI4NWU%3D\/014\/453\/0322\/000007_83785454f22ubo2b4d6bdd_D.jpg",
	"colorization_data": {
		"id": "colorizationdata-144530322-1000007"
	},
	"thumbnails": [
		{
			"url": "https:\/\/sites-cf.mhcache.com\/e\/1\/WC1BbXotQ29udGVudC1TaGEyNTY9VU5TSUdORUQtUEFZTE9BRCZYLUFtei1DcmVkZW50aWFsPUFLSUFYRDZIUllIRUlUVzRHV0VCJTJGMjAyMjA2MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjIwNjI3VDA2MDAwMFomWC1BbXotRXhwaXJlcz02MDQ4MDAmWC1BbXotU2lnbmF0dXJlPWY1ZjE0YzY1MDk2MzM0NDlhNzY4ZmE0OGU2NGMwOTIwOTI0MmMwYTE5NTk4NjRmMmE4NTI0ZTU5MmEzNjI4NWU%3D\/014\/453\/0322\/000007_83785454f22ubo2b4d6bdd_D.jpg",
			"width": 473,
			"height": 600,
			"class_name": "Image"
		},
		{
			"url": "https:\/\/sites-cf.mhcache.com\/t\/530\/322\/144530322\/000\/000007_83785454f22ubo2b4d6bdd_D_202x256\/R_IAv-54z4djOPFYnasxsU9UZwc=\/.jpg",
			"width": 202,
			"height": 256,
			"class_name": "Image"
		},
		{
			"url": "https:\/\/sites-cf.mhcache.com\/t\/530\/322\/144530322\/000\/000007_83785454f22ubo2b4d6bdd_D_32x40\/U_XRRdNbPB0X9jBeUuWy14a4yA4=\/.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"
	},
	"is_bw": "unknown",
	"is_scratched": "unknown",
	"is_photo_animated": false,
	"audio_count": 0,
	"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:\/\/sites-cf.mhcache.com\/e\/1\/WC1BbXotQ29udGVudC1TaGEyNTY9VU5TSUdORUQtUEFZTE9BRCZYLUFtei1DcmVkZW50aWFsPUFLSUFYRDZIUllIRUlUVzRHV0VCJTJGMjAyMjA2MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjIwNjI3VDA2MDAwMFomWC1BbXotRXhwaXJlcz02MDQ4MDAmWC1BbXotU2lnbmF0dXJlPWIxYjUxZWI4ZGU0MmZlNjk5NThhM2Y3MDMxODQ4NWFlNDEwNmVmZTgzMmQ5YmJlYjM3YzJjYTA0MzM1ZTU2NTU%3D\/014\/453\/0322\/000394_7468270bb32w7fd68bn824_D.flv",
	"thumbnails": [
		{
			"url": "https:\/\/sites-cf.mhcache.com\/e\/1\/WC1BbXotQ29udGVudC1TaGEyNTY9VU5TSUdORUQtUEFZTE9BRCZYLUFtei1DcmVkZW50aWFsPUFLSUFYRDZIUllIRUlUVzRHV0VCJTJGMjAyMjA2MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjIwNjI3VDA2MDAwMFomWC1BbXotRXhwaXJlcz02MDQ4MDAmWC1BbXotU2lnbmF0dXJlPWIzYzAxNmRmM2Y2ODdiYzI3ODNhZDFjYmZhODVmMjBjYTVkMWE1ODg3YmZkYWU0NzZjMDM5MzA1ZTBlODQ0MzY%3D\/014\/453\/0322\/000394_85223626w3vb24g3vb7fdp_D.jpg",
			"width": 160,
			"height": 120,
			"class_name": "Image"
		},
		{
			"url": "https:\/\/sites-cf.mhcache.com\/t\/530\/322\/144530322\/000\/000394_85223626w3vb24g3vb7fdp_D_40x30\/T9i4-cL6tYzVFduG82P0DFoOcMg=\/.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:\/\/sites-cf.mhcache.com\/e\/1\/WC1BbXotQ29udGVudC1TaGEyNTY9VU5TSUdORUQtUEFZTE9BRCZYLUFtei1DcmVkZW50aWFsPUFLSUFYRDZIUllIRUlUVzRHV0VCJTJGMjAyMjA2MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjIwNjI3VDA2MDAwMFomWC1BbXotRXhwaXJlcz02MDQ4MDAmWC1BbXotU2lnbmF0dXJlPWE4MzE4MmI1ZjQwNmIzZGRjNDAxMDVhMDFiNTZkY2U2MTYyZmRjMjBiMTA5OTA5YTI3ODU2ZjRhMTQxZDAwZGU%3D\/014\/453\/0322\/000009_4614646pof4gd42b425bgv_D.doc",
	"thumbnails": [
		{
			"url": "https:\/\/sites-cf.mhcache.com\/e\/1\/WC1BbXotQ29udGVudC1TaGEyNTY9VU5TSUdORUQtUEFZTE9BRCZYLUFtei1DcmVkZW50aWFsPUFLSUFYRDZIUllIRUlUVzRHV0VCJTJGMjAyMjA2MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjIwNjI3VDA2MDAwMFomWC1BbXotRXhwaXJlcz02MDQ4MDAmWC1BbXotU2lnbmF0dXJlPTljYTQ3ZDUwYzQ1MWRiOWU3N2QxNGEwYmMxZWUxMjY0NzA1MjU4ZmZhYmE2ODdlYjAzZmUxMDY1MDQ4NjBkYzI%3D\/014\/453\/0322\/000009_31572441dy19c5b7f7l6p6_Z.jpg",
			"width": 111,
			"height": 142,
			"class_name": "Image"
		},
		{
			"url": "https:\/\/sites-cf.mhcache.com\/t\/530\/322\/144530322\/000\/000009_31572441dy19c5b7f7l6p6_Z_31x40\/izQietfJm0iYZskelcYp06FwASw=\/.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:\/\/sites-cf.mhcache.com\/e\/1\/WC1BbXotQ29udGVudC1TaGEyNTY9VU5TSUdORUQtUEFZTE9BRCZYLUFtei1DcmVkZW50aWFsPUFLSUFYRDZIUllIRUlUVzRHV0VCJTJGMjAyMjA2MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjIwNjI3VDA2MDAwMFomWC1BbXotRXhwaXJlcz02MDQ4MDAmWC1BbXotU2lnbmF0dXJlPWY2M2QwZjExNzQ4OTA1ZTY3NDI4NTVmYjk3YjQwZDNlMjIwODYxMmE2NjI0MDQyODZhMDQ0MGU5MWJiNGQxZmI%3D\/014\/453\/0322\/000001_014600em83i3l5d462ce4u_D.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"
}