REST request URL
http://api.appletree.com/photos/person/{id}?key={api_key}&branch={affiliate_code}&start={start_count}&max={max_results}
Developer API
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.
PhotosOfPerson
Search photos of people within Appletree.
photos/person/{phrase}
phrase | Search phrase to find photos
id | profile id or an affiliate's id if a branch is specified
key | api key given by AppleTree.com
branch (optional) | affiliate code (fs - new Family Search) for people tagged with an identifier of an affiliate
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/photos/person/Scott_Allen_Mueller_1?key=asdf1234
http://api.appletree.com/photos/person/ASD123?key=asdf1234&branch=fs&start=5&max=8
1 <photos total="30">
2 <photo id="123" uploader="Scott_Mueller_1" name="p4.jpg" web-name="p4,jpg" title="Scott's parents"/>
3 <person id="345" profile="Allen_Orville_Mueller_1"/>
4 <person id="567" profile="Moira_Fiore_1"/>
5 </photo>
6 </photos>
2 <photo id="123" uploader="Scott_Mueller_1" name="p4.jpg" web-name="p4,jpg" title="Scott's parents"/>
3 <person id="345" profile="Allen_Orville_Mueller_1"/>
4 <person id="567" profile="Moira_Fiore_1"/>
5 </photo>
6 </photos>
Error codes
400 | Invalid parameters
403 | Invalid API key
404 | Person not found
Constructing webpage URLs
http://www.appletree.com/photos/{uploader}/{photo_web_name}
http://www.appletree.com/photos/{uploader}/{profile_of_person_in_photo}/{photo_web_name}
if uploader and person is the same, only specify the uploader
uploader | profile id of the uploader
profile_of_person_in_photo | profile id of person in the photo
photo_web_name | web name for photo
Examples
http://www.appletree.com/images/Scott_Allen_Mueller_1/pew84gep_large,jpg
http://www.appletree.com/photos/Scott_Allen_Mueller_1/Moira_Fiore_1/pew84gep_large,jpg
http://www.appletree.com/photos/Scott_Allen_Mueller_1/IMG_1525,jpg
Constructing image URLs
http://images.appletree.com/person/{uploader.lowerCase}/{size}/{photo_name}
http://images.appletree.com/person/{uploader.lowerCase}/{photo_name}
size
small | up to 200x150 pixels
medium | up to 400x300 pixels
large | up to 800x600 pixels
<unspecified> | original size
uploader.lowerCase | profile id of the uploader in lowercase
Examples
http://images.appletree.com/person/scott_allen_mueller_1/small/pew84gep_large.jpg
http://images.appletree.com/person/scott_allen_mueller_1/small/IMG_1525.jpg
http://images.appletree.com/person/scott_allen_mueller_1/IMG_1525.jpg
