Photo

A photo 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 photos and other media items using tags. Photos contain several thumbnail images in several different sizes. Photos and other media items can be organized in albums in the family site.

Fields

The Photo object contains the following fields:

Name	Description	Type	Access Mode
id	The photo's id	id	read
type	The media item type	string	read
name	The photo's name (title)	string	read, write
date	When the photo was taken	EventDate object: gedcom, text, date, structured_date and class_name fields	read, write
place	Where a photo was taken	string	read, write
description	The photo's description	string	read, write
link	Link to photo on MyHeritage.com	string	read
url	The url for the photo	string	read
photo_versions	Set of all the photo versions related to photo	array of PhotoVersion objects containing the	read, write
colorization_data	Holder of information about colorized version	ColorizationData object: id field	read, write
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
width	The width of the photo in pixels	int	read
height	The height of the photo in pixels	int	read
extension	The extension of the photo's file name	string	read
has_reverse_side	Indicates whether the photo has a reverse site or not	boolean	read
reverse_side_width	The photo reverse side width	int	read
reverse_side_height	The photo reverse side height	int	read
reverse_side_images	The reverse side images	array of Image objects containing the url, width, height and class_name fields	read
submitter	The user who submitted the photo to the site	User object: id and name fields	read
created_time	The time when the photo was submitted to the site	string (YYYY-MM-DD HH:MM:SS)	read
updated_time	The date and time when the photo was last updated on the site	string (YYYY-MM-DD HH:MM:SS)	read
is_personal_photo	Indicates whether the photo is a personal photo or not	boolean	read, write
personal_photo_individual	The personal photo individual	Individual object: id and name fields	read
site	The site of the photo	Site object: id and name fields	read
source	Id of the photo file part in format 'cid:<filename>'	string	write
colorize_portraits	Colorize all portraits	boolean	write
bw_detection_status	BW Detection status requested - Requested started - Started done - Done failed - Failed	string	read, write
scratch_detection_status	Scratches Detection status requested - Requested started - Started done - Done failed - Failed	string	read, write
scratch_detection_sensitivity	Scratches Detection sensitivity, default is low low - Low medium - Medium high - High	string	read, write
is_bw	Detected color unknown - Unknown bw - B&W color - Color	string	read
is_scratched	Scratches detection result unknown - Unknown scratched - Scratched normal - Normal	string	read
is_photo_animated	Photo has at least one completed animation	boolean	read
audio_count	The number of audios associated with the photo	int	read
class_name	The object class name	string	read

Connections

The Photo object contains the following connections:

Name	Description	Type	Access Mode
keywords	Keywords associated with the photo	array of strings	read
items	List of objects that are associated with the photo (individuals, families, events, family events and sources)	array of TreeItem objects	read
albums	List of albums the photo is in	array of Album objects	read
tags	List of tags of individuals in the photo	array of Tag objects	read, write
comments	List of comments associated with the photo	array of Comment objects	read
audios	List of audios associated with the photo	array of Audio objects	read, write
replace_photo_action	Photo replacement action	array of Photo objects	write

Example

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\/WC1BbXotQ29udGVudC1TaGEyNTY9VU5TSUdORUQtUEFZTE9BRCZYLUFtei1DcmVkZW50aWFsPUFLSUFYRDZIUllIRUlUVzRHV0VCJTJGMjAyMjA2MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjIwNjI3VDA0MDAwMFomWC1BbXotRXhwaXJlcz02MDQ4MDAmWC1BbXotU2lnbmF0dXJlPTYwOWI2ODE0Yjg1Y2EzODFmYzgxNGJiZTY0OTU3ZTU5MjI1ZDY4ZmUyOGE0ZmZlNjRlYmJkMjczMTRmMGEyMDk%3D\/014\/453\/0322\/000007_83785454f22ubo2b4d6bdd_D.jpg",
	"colorization_data": {
		"id": "colorizationdata-144530322-1000007"
	},
	"thumbnails": [
		{
			"url": "https:\/\/sites-cf.mhcache.com\/e\/1\/WC1BbXotQ29udGVudC1TaGEyNTY9VU5TSUdORUQtUEFZTE9BRCZYLUFtei1DcmVkZW50aWFsPUFLSUFYRDZIUllIRUlUVzRHV0VCJTJGMjAyMjA2MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjIwNjI3VDA0MDAwMFomWC1BbXotRXhwaXJlcz02MDQ4MDAmWC1BbXotU2lnbmF0dXJlPTYwOWI2ODE0Yjg1Y2EzODFmYzgxNGJiZTY0OTU3ZTU5MjI1ZDY4ZmUyOGE0ZmZlNjRlYmJkMjczMTRmMGEyMDk%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"
}