From Wiki

Revision as of 13:50, 22 March 2010 by Scott (talk | contribs) (Added search to profiles)
Jump to: navigation, search

API Notes

  • OAuth authentication.
  • Can also make calls using web browser once you're logged in.
  • First pass will be read-only.

Global Parameters

These parameters can be used in any API call.


  • json.
  • ged (GEDCOM 5.5).
  • xml (not-GEDCOM 6).

Profile Access

geni.com/api/v1/profiles/current.<format>?<parameters> current user's profile
geni.com/api/v1/profiles/<id>.<format>?<parameters> profile for given ID
geni.com/api/v1/profiles.<format>?<parameters> your immediate family
geni.com/api/v1/profiles.<format>?ids=<id,id,...> profiles for given IDs (up to 50)
geni.com/api/v1/profiles/search.<format>?<search_field>=<search_value>&<search_field>=<search_value> Search for profiles (up to 50 returned)


Permission required for some.

  • First Name.
  • Middle Name.
  • Last Name.
  • Display Name.
  • Birth Event Id.
  • Birth Date.
  • Birth Location.
  • Death Event Id.
  • Death Date.
  • Death Location.
  • Residence Event Ids.
  • Current Location/Place of Burial.
  • Merge profile ids.
  • TBD (feel free to add desired fields here).

Search Fields

  • given_name
  • middle_name
  • surname
  • birth_date
  • birth_location
  • death_location
  • burial_location


Permission required for some.

  • include_events - add full event details (including location) to result.
  • include_merges - add full profile info to result.


Tree Access

geni.com/api/v1/trees/<walk>/<id>.<format> walk starting with other profile


  • ancestors.
  • blood_tree.
  • descendants.
  • forest.
  • immediate_family.


  • Marriage id.
  • Partner ids.
  • Children ids.


Event Access


Media Access

Photos, Videos, Documents, Links, ...

geni.com/api/v1/media/<id>.<format> meta-data for media
geni.com/api/v1/media/tagged.<format>?profile_id=<id> meta-data for media tagged with id
geni.com/api/v1/media/photo/<id>-<size> jpeg photo by id and size
geni.com/api/v1/media/video/<id> flv video by id


  • original.
  • large.
  • medium.
  • small.
  • t (thumbnail).
  • t2 (cropped thumbnail).


Personal tools