usernames.me API

Our simple REST API allows you to grab any profile format from our directory of sites.

XML or JSON, just append .xml or .json to the end of the request string (defaults to json).

To get a full list of our available formats: http://usernames.me/api/grab/all.json

To get an individual format: http://usernames.me/api/grab/[service name].xml

This is an open API, feel free to use it wherever you'd like. Credit is appreciated.

Example Responses

http://usernames.me/api/grab/all.json

[{
  "name":"facebook",
  "format":"http:\/\/facebook.com\/:username",
  "icon":"http:\/\/usernames.me\/social\/facebook.png"
},{
  "name":"twitter",
  "format":"http:\/\/twitter.com\/:username",
  "icon":"http:\/\/usernames.me\/social\/twitter.png"
},
...
]

http://usernames.me/api/grab/all.xml

<?xml version="1.0" encoding="UTF-8"?>
<services>
  <service>
    <name>facebook</name>
    <format>http://facebook.com/:username</format>
    <icon>http://usernames.me/social/facebook.png</icon>
  </service>
  <service>
    <name>twitter</name>
    <format>http://twitter.com/:username</format>
    <icon>http://usernames.me/social/twitter.png</icon>
  </service>
  ...
</services>

http://usernames.me/api/grab/facebook

{
  "name":"facebook",
  "format":"http:\/\/facebook.com\/:username",
  "icon":"http:\/\/usernames.me\/social\/facebook.png"
}

http://usernames.me/api/grab/facebook.xml

<?xml version="1.0" encoding="UTF-8"?>
<services>
  <service>
    <name>facebook</name>
    <format>http://facebook.com/:username</format>
    <icon>http://usernames.me/social/facebook.png</icon>
  </service>
</services>