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
api.mapmyuser
Request parameters

site	domain name eg: google Don't include http or www
output	json (default), 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
api.mapmyuser
Request parameters

site	domain name eg: google Don't include http or www
output	json (default), 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> 
<BROWSER>Chrome</BROWSER>
<OS>WinXP</OS>
<LOCATION country="IN" city="Calicut" lat="11.25" long="75.7667007446" /> 
<SOURCE>Referral</SOURCE>  
<KEY><![CDATA[sewatch]]></KEY>
<TIME>1331794664</TIME>
</User>
<User>
<IP>42.2.10.95</IP>
<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>
<BROWSER>IE</BROWSER>
<OS>WinXP</OS>
<LOCATION country="A1" city="Unknown" lat="0" long="0" />
<SOURCE>Referral</SOURCE>
<KEY><![CDATA[sewatch]]></KEY>
<TIME>1331794560</TIME>
</User>
<User>
<IP>87.184.175.122</IP>
<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.
;)