API Documentation

DandyID's API gives developers the ability to create better social networks by allowing users to more clearly define who they are, helping them to connect with one another on a more personal level, and making it easier for new users to get up and running more quickly. User experience is important, and users on DandyID-enabled sites form tighter bonds with each other and connect in more meaningful ways. DandyID tools can help you turn casual visitors into die-hard fans.

Getting started with the DandyID API is easy. First apply for an API key, then check out our API documentation below. Also, visit Extend & Share to see some of the apps built on our API. If you have any quesions, or would like to become a trusted partner, please contact us.

PROFILE:
No one wants to fill out the same form over and over. Save your users time and reduce headaches by leveraging the return_profile API call to access a user's globally recognizable profile.

IDENTITIES:
The return_services and reverse_lookup API calls lets you discover where your users exist on over 250 sites. Use that information to understand them better, connect with them in more meaningful ways and tap into their other online activities.

CONTACTS:
(coming soon) A social network is nothing without friends. The return_contacts API call make it easy for your users to connect with their existing contacts on your service.

Portable Contacts:
DandyID also supports Portable Contacts -- an open standard that combines some of the functionality of the API calls listed above.
Pro Accounts:
Additional data and API calls are available for our partners, please contact us if you are interested.

return_services

Returns a list of a services associated with a specific user.

This call is great if you want to learn more about a particular user's other online services (e.g. twitter, digg, del.icio.us, etc.). Lookup is done via email address, so integration with your existing users is a snap (provided they opt-in to dandyId -- we don't return anything without the user's permission).

Note: Unless you are trying to retrieve data that you have pushed into DandyID or that was created as a result of first calling sync_user, then set the optional profile_type parameter to "public"

Request URL: GET

http://www.dandyId.org/api/return_services/{api_key}/{user_identifier}

GET Request parameters

Parameter	Type	Description
api_key	string (required)	Your api key
user_identifier	string (required)	Can be either an MD5 hashed email address or DandyID user id
profile_type	string (optional)	Set to "public" to directly query DandyID's public repository.

Values Returned as XML

Parameter	Type	Description
svcId	string	Id of the service on dandyId (one word all lowercase).
svcName	string	Displayable name of the service, (use this to output to users, not svcId).
usrSvcId	string	Unique identifier of the user for corresponding service. Note: only returns data for trusted partners and/or users with pro accounts.
url	string	Url to the user's public profile on the corresponding service.
verified	string (TRUE or FALSE)	Returns TRUE if the user has verified the service externally.
svcFavicon	string	Location of favicon for service (hosted by DandyID).

Sample Response

The following is a sample response:

<?xml version="1.0" encoding="iso-8859-1"?>
		<services>
		  <service>
		    <svcId>aim</svcId>
		    <svcName>AIM</svcName>
		    <usrSvcId>arronkallenberg</usrSvcId>
		    <url>http://profiles.aim.com/arronkallenberg</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/aim.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>bluedot</svcId>
		    <svcName>Blue Dot (Faves)</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://faves.com/users/kallena</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/bluedot.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>brightkite</svcId>
		    <svcName>Brightkite</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://brightkite.com/people/kallena</url>
		    <verified>TRUE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/brightkite.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>claimid</svcId>
		    <svcName>claimID</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://claimid.com/kallena</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/claimid.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>couchsurfing</svcId>
		    <svcName>CouchSurfing</svcName>
		    <usrSvcId>6PE7K7K</usrSvcId>
		    <url>http://www.couchsurfing.com/profile.html?id=6PE7K7K</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/couchsurfing.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>delicious</svcId>
		    <svcName>Delicious</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://delicious.com/kallena</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/delicious.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>digg</svcId>
		    <svcName>Digg</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://digg.com/users/kallena</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/digg.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>dopplr</svcId>
		    <svcName>Dopplr</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://www.dopplr.com/traveller/kallena</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/dopplr.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>facebook</svcId>
		    <svcName>Facebook</svcName>
		    <usrSvcId>506118838</usrSvcId>
		  	<url>http://www.facebook.com/profile.php?id=506118838</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/facebook.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>flickr</svcId>
		    <svcName>Flickr</svcName>
		    <usrSvcId>arronkallenberg</usrSvcId>
		    <url>http://flickr.com/photos/arronkallenberg</url>
		    <verified>TRUE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/flickr.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>friendfeed</svcId>
		    <svcName>Friendfeed</svcName>
		    <usrSvcId>arron</usrSvcId>
		    <url>http://www.friendfeed.com/arron</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/friendfeed.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>googlereader</svcId>
		    <svcName>Google Reader</svcName>
		    <usrSvcId>02852881231942661999</usrSvcId>
		    <url>http://www.google.com/reader/shared/02852881231942661999</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/googlereader.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>intensedebate</svcId>
		    <svcName>Intense Debate</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://intensedebate.com/people/kallena</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/intensedebate.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>lijit</svcId>
		    <svcName>Lijit</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://www.lijit.com/users/kallena</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/lijit.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>linkedin</svcId>
		    <svcName>Linkedin</svcName>
		    <usrSvcId>arronkallenberg</usrSvcId>
		    <url>http://www.linkedin.com/in/arronkallenberg</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/linkedin.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>mybloglog</svcId>
		    <svcName>MyBlogLog</svcName>
		    <usrSvcId>arron</usrSvcId>
		    <url>http://www.mybloglog.com/buzz/members/arron</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/mybloglog.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>myopenid</svcId>
		    <svcName>myOpenID</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>https://kallena.myopenid.com/</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/myopenid.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>myspace</svcId>
		    <svcName>MySpace</svcName>
		    <usrSvcId>arronkallenberg</usrSvcId>
		    <url>http://www.myspace.com/arronkallenberg</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/myspace.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>pandora</svcId>
		    <svcName>Pandora</svcName>
		    <usrSvcId>arron5</usrSvcId>
		    <url>http://www.pandora.com/people/arron5</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/pandora.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>plaxo</svcId>
		    <svcName>Plaxo</svcName>
		    <usrSvcId>arronkallenberg</usrSvcId>
		    <url>http://arronkallenberg.myplaxo.com/</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/plaxo.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>pownce</svcId>
		    <svcName>Pownce</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://pownce.com/kallena</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/pownce.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>reddit</svcId>
		    <svcName>Reddit</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://reddit.com/user/kallena</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/reddit.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>rinexus</svcId>
		    <svcName>RI Nexus</svcName>
		    <usrSvcId>821</usrSvcId>
		    <url>http://rinexus.com/user/821</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/rinexus.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>shelfari</svcId>
		    <svcName>Shelfari</svcName>
		    <usrSvcId>o1517293616</usrSvcId>
		    <url>http://www.shelfari.com/o1517293616</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/shelfari.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>socialthing</svcId>
		    <svcName>Socialthing</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://kallena.socialthing.com/</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/socialthing.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>technorati</svcId>
		    <svcName>Technorati</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://www.technorati.com/people/technorati/kallena</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/technorati.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>tumblr</svcId>
		    <svcName>Tumblr</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://kallena.tumblr.com</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/tumblr.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>twitter</svcId>
		    <svcName>Twitter</svcName>
		    <usrSvcId>kallena</usrSvcId>
		    <url>http://twitter.com/kallena</url>
		    <verified>TRUE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/twitter.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>viddler</svcId>
		    <svcName>Viddler</svcName>
		    <usrSvcId>wildalaskan</usrSvcId>
		    <url>http://www.viddler.com/explore/wildalaskan</url>
		    <verified>FALSE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/viddler.png</svcFavicon>
		  </service>
		  <service>
		    <svcId>youtube</svcId>
		    <svcName>YouTube</svcName>
		    <usrSvcId>kallenarron</usrSvcId>
		    <url>http://youtube.com/user/kallenarron</url>
		    <verified>TRUE</verified>
		    <svcFavicon>http://www.dandyid.org/code/images/miscellaneous/favicons/youtube.png</svcFavicon>
		  </service>
		</services>