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

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

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

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:\/\/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"
}