Username or Email
Password   forgot password?
Search users

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.


    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.


    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.


    (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.


Returns a list of DandyID users that match the svcId / usrSvcId combo passed into the call. You can also pass just a usrSvcId with generic_lookup.

This call is great if you have a username on a particular service and would like to retrieve the associated DandyID user(s) from the DandyID repository.

Request URL: GET{api_key}/{svcId}/{usrSvcId}

GET Request parameters

Parameter Type Description
api_key string (required) Your api key
svcId string (required) ID of the service (i.e. "twitter", "aim" or "brighkite"). Hint: use service_details to retrieve a service's ID. ALTERNATE USE: if you don't have a specific service ID, enter the string "generic_lookup"; this will search all services matching the usrSvcId entered.
usrSvcId string (required) User's identifier / username associated with the service (i.e. "kallena" on twitter).

Values Returned as XML

Parameter Type Description
verified string Returns "TRUE" if the usrSvcId passed in has been verified for the user returned. If the usrSvcId has not been verified then "FALSE" will be returned.
userId integer DandyID user id of the associated user.
emailHash string MD5 Hash of the user's email address.

Sample Requests

Lookup "kallena" on "twitter"{api_key}/twitter/kallena

Lookup "arronkallenberg" on "aim"{api_key}/aim/arronkallenberg

Lookup "arronkallenberg" with "generic_lookup"{api_key}/generic_lookup/arronkallenberg

Sample Response

The following is a sample response: