Developer

API Rules

Cache the results of your API queries.
Follow our 'Branding Guidelines' - see below, on the left.
If your site receives a fair amount of traffic, do not set up your integration so our server is queried upon each page request on your site.
If you are doing a bulk set of requests, make no more than one request per five seconds.
Do not query for member's data unless they've given you their member name.
We reserve the right to request that you not use our service, and/or block your access due to abuse.
We do not provide the email address for any member of our service
If you use our API, please let us know, we'll even add a link to you!

API Introduction

example profile widget

Create Profile Widgets and More

The SocialNetwork.in API provides RSS2 feeds containing links and profile names of our members. Members of our site can aggregate their many website profile links and links to their friends profiles with our easy to use interface. We support more than 100 popular social networks, social bookmarking sites, and other services which support member profiles.

As a developer, you can extend your site and services by connecting to our API, and connecting your members to their SocialNetwork.in profile. Once you've made the connection, you now have the means to display a 'profile widget' or go even further and connect to the other profiles the given user has, and display their content. The screenshot to the right shows an example of a profile widget as used on ArtistServer.com.

This is great for mashups, with a single member profile, you can tap into any of the 100's of sites we provide profile linking to. If your site's members are not using SocialNetwork.in yet, ask them to join and start extending your site and adding value for your members.

API Method: Status

URL: http://socialnetwork.in/api.cfm/v/1.0/member/*UserName*/source/status
Description: Used to verify if a member exists in the SocialNetwork.in database. If the member is found, we return the date they last signed in and updated their account.

Results: Member Exists

	<?xml version="1.0" encoding="UTF-8"?>
		<member>
			<datestamp>Sat, 21 Jul 2007 01:20:35 PST</datestamp>
		</member>

Results: Member Does Not Exist

	<?xml version="1.0" encoding="UTF-8"?>
		<member>
			<datestamp />
		</member>

API Method: Profile

URL: http://socialnetwork.in/api.cfm/v/1.0/member/*UserName*/source/profile
Description: Returns an RSS2 feed containing the URLs, profile names, and site icons for each site the given member has a profile at. Each profile/site link is shown ast a separate item in the feed.

Results:

<?xml version="1.0" encoding="UTF-8"?> 
<rss version="2.0">
<channel>
	<title>SocialNetwork.in: Profile Feed</title>
	<link>http://socialnetwork.in/index.cfm/member/gideonmarken</link>
	<description>RSS Feed of Profiles for: gideonmarken</description>
	<language>en-us</language>
	<lastBuildDate>Sat, 21 Jul 2007 01:20:35 PST</lastBuildDate>
	<docs>http://backend.userland.com/rss</docs>
	<generator>http://socialnetwork.in</generator>
	<managingEditor>gideonmarken <NotAnAddress@nospam.com></managingEditor> 
	<webMaster>NotAnAddress@nospam.com</webMaster>
	<pubDate>Sat, 21 Jul 2007 03:23:20 PST</pubDate> 
	<ttl>1440</ttl>  
<item>
	<title>SonicWallpaper</title>
	<link>http://www.artistserver.com/SonicWallpaper</link>
	<author><NotAnAddress@nospam.com> (gideonmarken)</author> 
	<pubDate>Thu, 04 Jan 2007 02:07:56 PST</pubDate> 
	<guid>http://www.artistserver.com/SonicWallpaper</guid> 
	<description>SonicWallpaper</description>
	<source url="http://www.artistserver.com">ArtistServer</source>
	<enclosure url="http://www.socialnetwork.in/siteicons/18.jpg" 
	length='980' type="image/jpg" />
</item> 
</channel>
</rss>

API Method: Friend

URL: http://socialnetwork.in/api.cfm/v/1.0/member/*UserName*/source/friend
Description:Returns an RSS2 feed containing URLs, profile names, site names, and site icons of friends for the passed member name.

Results:

<?xml version="1.0" encoding="UTF-8"?> 
<rss version="2.0">
<channel>
	<title>SocialNetwork.in: Profile Feed</title>
	<link>http://socialnetwork.in/index.cfm/member/gideonmarken</link>
	<description>RSS Feed of Profiles for: gideonmarken</description>
	<language>en-us</language>
	<lastBuildDate>Sat, 21 Jul 2007 01:20:35 PST</lastBuildDate>
	<docs>http://backend.userland.com/rss</docs>
	<generator>http://socialnetwork.in</generator>
	<managingEditor>gideonmarken <NotAnAddress@nospam.com>
	</managingEditor> <webMaster>NotAnAddress@nospam.com</webMaster> 
	<pubDate>Sun, 22 Jul 2007 02:55:58 PST</pubDate> <ttl>1440</ttl> 
<item>
	<title>icotec</title>
	<link>http://www.artistserver.com/icotec</link>
	<author><NotAnAddress@nospam.com> (gideonmarken)</author>
	<pubDate>Tue, 09 Jan 2007 01:06:24 PST</pubDate> 
	<guid>http://www.artistserver.com/icotec</guid>
	<description>ArtistServer</description>
	<source url="http://www.artistserver.com">ArtistServer</source>
	<enclosure url="http://www.socialnetwork.in/siteicons/18.jpg" 
	length='980' type="image/jpg" />
</item> 
</channel>
</rss>

API Method: Link

URL: http://socialnetwork.in/api.cfm/v/1.0/member/*UserName*/source/link
Description:Returns an RSS2 feed containing URLs, site names, and site icons of sites the passed member name has linked to.

Result:

<?xml version="1.0" encoding="UTF-8"?> 
<rss version="2.0">
<channel>
	<title>SocialNetwork.in: Profile Feed</title>
	<link>http://socialnetwork.in/index.cfm/member/gideonmarken</link>
	<description>RSS Feed of Profiles for: gideonmarken</description>
	<language>en-us</language>
	<lastBuildDate>Sat, 21 Jul 2007 01:20:35 PST</lastBuildDate>
	<docs>http://backend.userland.com/rss</docs>
	<generator>http://socialnetwork.in</generator>
	<managingEditor>gideonmarken <NotAnAddress@nospam.com></managingEditor> 
	<webMaster>NotAnAddress@nospam.com</webMaster> 
	<pubDate>Sun, 22 Jul 2007 03:01:19 PST</pubDate> 
	<ttl>1440</ttl> 
<item>
	<title>Flickr</title>
	<link>http://www.flickr.com</link>
	<author><NotAnAddress@nospam.com> (gideonmarken)</author> 
	<pubDate>Fri, 05 Jan 2007 05:34:14 PST</pubDate> 
	<guid>http://www.flickr.com</guid>
	<description>Flickr</description>
	<source url="http://www.flickr.com">Flickr</source>
	<enclosure url="http://www.socialnetwork.in/siteicons/1.jpg" 
	length='980' type="image/jpg" />
</item> 
</channel>
</rss>

Errors

If there is an error with your request, you'll receive the following result:

<?xml version="1.0" encoding="UTF-8"?>  
<error>there was an error with your request</error>

Branding Guidelines

Always include our URL and a link to our site when displaying data served from this service. You may use either one of the following:

Powered by SocialNetwork.in
Profile Aggregation by SocialNetwork.in