API Overview

Mapmyuser API provides access to analytic data available at Mapmyuser about any website. You can use this API to develop applications or scripts to show stats of any website.

Mapmyuser API Services

Usercount

show number of visitors online on website
Request URL
http://api.mapmyuser.com/usercount.php
Request parameters
site domain name
eg: google.com, xyz.blogspot.com
Don't include http or www
output json (default), xml

Sample Request Url
http://api.mapmyuser.com/usercount.php?site=toolspot.org&output=xml
Response fields
USER number of users online

Sample response

<?xml version="1.0" encoding="UTF-8" ?>
<USERS>5</USERS>

UserInfo

Show details of every visitor who’s currently online
Request URL
http://api.mapmyuser.com/userinfo.php
Request parameters
site domain name
eg: google.com, xyz.blogspot.com
Don't include http or www
output json (default), xml

Sample Request Url
http://api.mapmyuser.com/userinfo.php?site=toolspot.org&output=xml
Response fields
Results Contains all of the query responses
User Contains detail for individual user.
URL url of site which user is viewing currently
BROWSER browser of user
OS os of user
Location location of user. Has attributes:
country: country of user
city: city of user
lat: latitude of user
long: longitude of user
SOURCE source of visit. ( i.e. Google, Yahoo, Bing, Referral Or Direct)
REF referring url or 0 for direct users
KEY Search keyword for search engine users
0 for direct users
domain name of referral users
TIME user active since in unix timestamp
Sample response

<?xml version="1.0" encoding="UTF-8" ?> 
<Results> 
<User> 
<IP>117.201.245.0</IP> 
<URL><![CDATA[http://toolspot.org/banklink-with-pagerank.php]]></URL>
<BROWSER>Chrome</BROWSER>
<OS>WinXP</OS>
<LOCATION country="IN" city="Calicut" lat="11.25" long="75.7667007446" /> 
<SOURCE>Referral</SOURCE>  
<REF><![CDATA[http://sewatch.net/report/googlika.com]]></REF>
<KEY><![CDATA[sewatch.net]]></KEY>
<TIME>1331794664</TIME>
</User>
<User>
<IP>42.2.10.95</IP>
<URL><![CDATA[http://toolspot.org/banklink-with-pagerank.php]]></URL>
<BROWSER>Android</BROWSER>
<OS>Android</OS>
<LOCATION country="HK" city="Unknown" lat="22.25" long="114.166702271" />
<SOURCE>Direct</SOURCE>
<REF><![CDATA[0]]></REF>
<KEY><![CDATA[0]]></KEY>
<TIME>1331794569</TIME>
</User>
<User>
<IP>65.49.14.79</IP>
<URL><![CDATA[http://toolspot.org/banklink-with-pagerank.php]]></URL>
<BROWSER>IE</BROWSER>
<OS>WinXP</OS>
<LOCATION country="A1" city="Unknown" lat="0" long="0" />
<SOURCE>Referral</SOURCE>
<REF><![CDATA[http://sewatch.net/report/xvideos.com]]></REF>
<KEY><![CDATA[sewatch.net]]></KEY>
<TIME>1331794560</TIME>
</User>
<User>
<IP>87.184.175.122</IP>
<URL><![CDATA[http://toolspot.org/]]></URL>
<BROWSER>Opera</BROWSER>
<OS>Win7</OS>
<LOCATION country="DE" city="Solingen" lat="51.1833000183" long="7.08330011368" />
<SOURCE>Direct</SOURCE>
<REF><![CDATA[0]]></REF>
<KEY><![CDATA[0]]></KEY>
<TIME>1331794345</TIME>
</User>
</Results>

Rate Limit

We don’t have any rate limit, But we are caching results for 5 sec. So it is recommended to call our api in interval of 5 sec to get fresh data.
;)