- Family Graph API
- Objects
- AggregateValueAdd
- Album
- Audio
- BuyNowData
- ChildInFamily
- Citation
- ColorizationData
- Comment
- Config
- ConfirmationStatus
- Counter
- Device
- DiscoveryBase
- DnaAncestorName
- DnaEnums
- DnaEthnicity
- DnaEthnicityReport
- DnaKit
- DnaKitFile
- DnaMatch
- DnaMatchCommonAncestor
- DnaMatchNote
- DnaMatchRelationship
- DnaOrderItemShippingDetails
- Document
- Enums
- EthnicityInLocation
- Event
- EventDate
- EventPlace
- ExportGEDCOM
- ExportGEDCOMStatus
- Family
- FamilyEvent
- GenealogyEvent
- GoalActivity
- Image
- Individual
- Installation
- Invitation
- MatchesCount
- MatchingRequest
- MediaItem
- Membership
- Navigation
- NavigationItem
- NavigationItemBadge
- NewPhotoInfo
- Note
- Notification
- NotificationHistory
- OrderItemCoupon
- OrderItemShippingDetails
- Page
- PersonalPhotosDiscovery
- Phones
- Photo
- PhotoVersion
- Range
- RecordColorizationData
- RecordIndividual
- RecordMatchesCount
- Relationship
- ResiEvent
- ShippingOption
- SingleDate
- Site
- SmartMatch
- Source
- StructuredDate
- StructuredPlace
- SubTree
- SuggestedRelative
- System
- Tag
- ThreadsCount
- Tree
- TreeItem
- User
- UserMenu
- ValueAddData
- ValueAddElement
- ValueAddFactor
- Video
- WorldEthnicities
- SDKs
- PHP SDK
- iOS SDK
- Android SDK
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 |
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
|
string |
read, write |
is_bw |
Detected color
|
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 |
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",
"colorization_data": {
"id": "colorizationdata-144530322-1000007"
},
"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"
},
"is_bw": "unknown",
"is_photo_animated": false,
"audio_count": 0,
"class_name": "Photo"
}