- Family Graph API
- Objects
- AggregateValueAdd
- Album
- Audio
- BuyNowData
- ChildInFamily
- Citation
- ColorizationData
- Comment
- Config
- ConfirmationStatus
- Counter
- Device
- DiscoveryBase
- DnaAncestorName
- DnaEnums
- DnaEthnicity
- DnaEthnicityReport
- DnaKit
- DnaKitFile
- DnaLabel
- 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
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){https://familygraph.myheritage.com/audio-144530322-1-1 (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"
}
{
"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"
}