- 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
Site
A family site as represented in the Family Graph API.
Family sites are created by users in order to have a website for their family. Users can invite other family members to the site. A family site can include several family trees, in which individuals and families are defined. A family site can also contain media items such as photos, documents, videos and audios.
Fields
The Site
object contains the following fields:
Name | Description | Type | Access Mode |
id |
The site's id |
id |
read |
name |
The site's name |
string |
read, write |
description |
The site's description |
string |
read |
sub_domain |
The site's sub-domain (subdomain.myheritage.com) |
string |
read |
welcome_message |
The site's homepage welcome message |
string |
read, write |
link |
Link to site on MyHeritage.com |
string |
read |
plan |
The site's subscription plan
|
string |
read |
privacy_policy |
The site's privacy policy
|
string |
read |
site_logo |
The site's logo image |
Photo object: id and name fields |
read |
creator |
The user who created the site |
User object: id and name fields |
read |
created_date |
The date when the site was created |
string (YYYY-MM-DD) |
read |
plan_expiry_date |
The date when the site's plan will expire (or has expired) |
string (YYYY-MM-DD) |
read |
default_tree |
The family tree in the site where users are taken to by default |
Tree object: id and name fields |
read |
default_root_individual |
The root individual in the default family tree |
Individual object: id and name fields |
read |
member_count |
The number of users who are members in the site |
int |
read |
album_count |
The number of media albums in the site |
int |
read |
media_count |
The number of media items in the site |
int |
read |
tree_count |
The number of family trees in the site |
int |
read |
news_count |
The number of news articles |
int |
read |
is_listed_in_site_center |
Indicates whether the site is listed in the site center |
boolean |
read |
can_members_edit_trees |
Indicates whether members of the site can edit trees of the site |
boolean |
read |
can_members_post_content |
Indicates whether members of the site can post content to the site |
boolean |
read |
can_member_manage_media |
Indicates whether the current member can manage media of the site |
boolean |
read |
is_request_membership_allowed |
Indicates whether users who are not members of the site can request membership in the site |
boolean |
read |
can_members_invite_other_members |
Indicates whether members of the site can invite other people to the site |
boolean |
read |
is_site_opened_for_guests |
Indicates whether guests can view limited information on the site |
boolean |
read |
notify_managers_on_membership_request |
Indicates whether managers of the site will be notified upon membership request in the site |
boolean |
read |
is_in_discoveries_cooloff |
Returns whether the site is in discoveries cooloff or not |
boolean |
read |
live_story_photo_upload_enabled |
Indicates whether the user can upload more photos for live story |
boolean |
read |
matches_count |
List of matches count in the site. In case matchescountfilter parameter is defined, returns array of matchescount objects |
MatchesCount object: match_type, pending, confirmed, rejected, total, new, ignored_sources, ignored_individuals, aggregated_value_add and class_name fields |
read |
available_quota |
Site quota left in bytes |
int |
read |
are_faces_indexed |
Indicates whether the site is fully indexed by face-recognition-service |
boolean |
read |
site_indexing_status |
Site indexing status
|
string |
read |
is_eligible_for_face_feature |
Indicate if the user eligible for face feature |
boolean |
read |
face_consent |
Indicate if the user approved/rejected/ignored the face consent
|
string |
read, write |
is_eligible_to_create_live_story |
Indicate if the user eligible for live story creation |
boolean |
read |
class_name |
The object class name |
string |
read |
Connections
The Site object contains the following connections:Name | Description | Type | Access Mode |
memberships |
List of users who are members of the site |
array of Membership objects |
read |
trees |
List of family trees in the site |
array of Tree objects |
read, write |
albums |
List of albums in the site |
array of Album objects |
read, write |
invitations |
List of invitations to the site |
array of Invitation objects |
read, write |
media |
List of media items in the site (sorted by created_date, most recent first) |
array of MediaItem objects |
read |
site_logo_photo |
The site's logo image |
Photo object |
read, write |
Example
https://familygraph.myheritage.com/site-144530322 (open in browser){
"id": "site-144530322",
"name": "Demo Family Site",
"description": "Demo family site for developers",
"sub_domain": "demosite",
"welcome_message": "This is a demo site for developers",
"link": "https:\/\/www.myheritage.com\/site-144530322\/demo-family-site",
"plan": "basic",
"privacy_policy": "public",
"creator": {
"id": "user-10",
"name": "Developer MyHeritage"
},
"created_date": "2011-03-03",
"plan_expiry_date": "2012-03-03",
"default_tree": {
"id": "tree-144530322-1",
"name": "jfk"
},
"default_root_individual": {
"id": "individual-144530322-1000028",
"name": "Joseph Patrick Kennedy II"
},
"member_count": 1,
"album_count": 6,
"media_count": 305,
"tree_count": 3,
"news_count": 0,
"is_listed_in_site_center": false,
"can_members_edit_trees": true,
"can_members_post_content": true,
"can_member_manage_media": true,
"is_request_membership_allowed": true,
"can_members_invite_other_members": true,
"is_site_opened_for_guests": true,
"notify_managers_on_membership_request": true,
"is_in_discoveries_cooloff": false,
"live_story_photo_upload_enabled": true,
"available_quota": 452092493,
"animation_drivers": [
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
},
{
}
],
"info_summary": {
"id": "sitesummary-144530322"
},
"are_faces_indexed": false,
"site_indexing_status": "NOT_INDEXED",
"is_eligible_for_face_feature": true,
"site_tagging_suggestions": {
"id": "sitetaggingsuggestions-144530322"
},
"live_story_suggested_individuals": [
{
"individual": {
"id": "individual-144530322-1000001",
"name": "John Fitzgerald Kennedy"
},
"portrait": {
"id": "photo-144530322-1-1000003",
"name": "John Fitzgerald Kennedy"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000005",
"name": "Joseph Patrick Kennedy"
},
"portrait": {
"id": "photo-144530322-1-1000136",
"name": "Joseph Patrick Kennedy"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000020",
"name": "Robert Francis \"Bobby\" Kennedy"
},
"portrait": {
"id": "photo-144530322-1-1000255",
"name": "Robert Francis Kennedy"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000006",
"name": "Rose Kennedy (born Fitzgerald)"
},
"portrait": {
"id": "photo-144530322-1-1000144",
"name": "Rose Kennedy [Fitzgerald]"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000014",
"name": "Eunice Kennedy Shriver (born Kennedy)"
},
"portrait": {
"id": "photo-144530322-1-1000233",
"name": "Eunice Kennedy Shriver [Kennedy]"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000008",
"name": "Patrick Joseph Kennedy"
},
"portrait": {
"id": "photo-144530322-1-1000152",
"name": "Patrick Joseph Kennedy"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000083",
"name": "Edward Moore (Ted) Kennedy"
},
"portrait": {
"id": "photo-144530322-1-1000332",
"name": "Edward Moore (Ted) Kennedy"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000009",
"name": "Mary Augusta Kennedy (born Hickey)"
},
"portrait": {
"id": "photo-144530322-1-1000156",
"name": "Mary Augusta Kennedy [Hickey]"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000045",
"name": "Michael Lemoyne Kennedy"
},
"portrait": {
"id": "photo-144530322-1-1000302",
"name": "Michael Lemoyne Kennedy"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000007",
"name": "John Francis \"Honey Fitz\" Fitzgerald"
},
"portrait": {
"id": "photo-144530322-1-1000148",
"name": "John Francis Fitzgerald"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000112",
"name": "Mary Josephine Fitzgerald (born Hannon)"
},
"portrait": {
"id": "photo-144530322-1-1000370",
"name": "Mary Josephine Fitzgerald [Hannon]"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000012",
"name": "Kathleen (Kick) Agnes \"Kick\" Cavendish (born Kennedy)"
},
"portrait": {
"id": "photo-144530322-1-1000228",
"name": "Kathleen (Kick) Agnes Cavendish [Kennedy]"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000010",
"name": "Joseph Patrick Kennedy, Jr."
},
"portrait": {
"id": "photo-144530322-1-1000223",
"name": "Joseph Patrick Kennedy, Jr."
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000011",
"name": "Rosemary Kennedy"
},
"portrait": {
"id": "photo-144530322-1-1000226",
"name": "Rosemary Kennedy"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000040",
"name": "David Anthony Kennedy"
},
"portrait": {
"id": "photo-144530322-1-1000296",
"name": "David Anthony Kennedy"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000118",
"name": "Bridget Kennedy (born Murphy)"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000117",
"name": "Patrick Kennedy"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000115",
"name": "Thomas Fitzgerald"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000116",
"name": "Rosanna Fitzgerald (born Cox)"
},
"class_name": "LiveStory_SuggestedIndividual"
},
{
"individual": {
"id": "individual-144530322-1000120",
"name": "Margaret M Hickey (born Field)"
},
"class_name": "LiveStory_SuggestedIndividual"
}
],
"is_eligible_to_create_live_story": true,
"class_name": "Site"
}