API Functions

Search

Individual


Making the wealth of data at AppleTree.com useful to other developers is a core part of our mission to great a single human family tree of the world more widely available and accessible.

The API's here are intended to allow you to connect to our system directly using simple server-side scripting.

These web services can be used to create Facebook Applications, Google Desktop Widgets, as well as integrating our existing data and services more into a website or software application. We welcome you to share your thoughts, feedback or ideas on how we can extend our API's to provide additional services.

To request a Developer Key, simply click the button above to get started.



PeopleSearch

Search people within Appletree using search phrases.

people/search/{phrase}

REST request URL
http://api.appletree.com/people/search/{phrase}?key={api_key}&start={start_count}&max={max_results}

phrase | Search phrase to find people by
key | api key given by AppleTree.com
start (optional) | starting position, defaults at 1
max (optional) | maximum result count, defaults at 20 and maximum possible is 40

Example request URLs
 http://api.appletree.com/people/search/scott%20mueller?key=asdf1234
 http://api.appletree.com/people/search/+mueller%20description:ceo?key=asdf1234&max=3

1 <people total="10">
2 <person profile="Scott_Mueller_1" name="Scott Mueller"/>
3 <person profile="Scott_Miller_1" name="Scott John Miller"/>
4 <person profile="Allen_Mueller_1" name="Allen Mueller"/>
5 </people>

Error codes
400 | Invalid parameters
403 | Invalid API key

Constructing webpage URLs
 http://www.appletree.com/{profile}

profile | profile id of the person

Examples
 http://www.appletree.com/Scott_Allen_Mueller_1
 http://www.appletree.com/Allen_Mueller_1

OR
OR