API - get social media information

Summary

This section explains how to retrieve social media data for Facebook, Twitter, LinkedIn and Google+ within specific dates.

API URL

http://w1.wifi-soft.com/wifilan/json/getSocialData

API Request

Following parameters need to be passed to the API

Parameter Name Constraint Description
cc required Unique customer code/password. You will find the customer code under Admin -> Profile section
sd required

Start Date for the query. YYYY-MM-DD format

e.g. 2015-11-01

ed required

End Date for the query. YYYY-MM-DD format

e.g. 2015-11-02

soc required The social media type. Following values are allowed - facebook, twitter, linkedin and google. (case sensitive)
hid optional Hotspot ID. If this parameter is passed, the sessions will be filtered using the ID. Location ID can be found under Authentication -> Hotspot -> List Hotspots section.

API Response

The response data is passed in JSON format.

The type of data will change based on the social media type passed in the request.

Facebook Response

Parameter Name Description
   
Facebook Id The facebook ID of the user. This ID uniquely identifies the user on facebook
Name Facebook name of the user
Gender User's gender as displayed in public profile
Facebook Email Email entered in facebook profile. Please note that this is optional data in facebook
Timezone The timezone of the user based on GMT. Negative number indicates the timezone behind GMT and positive number for timezone ahead of GMT
Locale The locale of the user in POSIX notation
Update Time The time when user had updated or posted on his Facebook wall. This value indicates how active the user is on facebook
Min Age Facebook provides age range of user in public profile. Min Age is the lower side of the user's age
Max Age Upper side of the user's age
Login Time The time when the user logged in at the hotspot using his Facebook account. YYYY-MM-DD HH:MM:SS format.
Location Name The location where the user logged in

 

Twitter Response

Parameter Name Description
   
Twitter Id The twitter ID of the user. This ID uniquely identifies the user on Twitter
Name The name as it appears in Twitter profile
Screen Name The screen name of the user
Followers Number of twitter users who are following the user
Friends Number of friends of the user on twitter
Statuses Number of tweets the user has posted so far
Following The number of twitter users whom the user is following
Twitter Location The location of the user according to twitter profile
Login Time The time when the user logged in at the hotspot using his Facebook account. YYYY-MM-DD HH:MM:SS format.
Location Name The location where the user logged in

 

LinkedIn Response

Parameter Name Description
   
LinkedIn Id The linkedin ID of the user. This ID uniquely identifies the user on LinkedIn
Name The name as it appears in LinkedIn profile
Email Address The email address in LinkedIn
Location The location listed in linkedin profile
Title The headline or title for the user
Birthday The birthday listed in linkedin profile
Industry The name of the industry where the user currently is working
Connection Number of LinkedIn connections
Position The current position for the user. This is a numeric value
Position Title The title for the current position
Login Time The date and time when the user had last logged in using his linkedin login
Location Name The name of the hotspot venue where the user had logged in

 

Google+ Response

Parameter Name Description
   
Google Id The Google ID of the user. This ID uniquely identifies the user on Google+
Name The name as it appears in Google profile
Email Address The email address registered with Google+
Gender The gender for the registered user
Locale The locale to which the user belongs. The locale of the user in POSIX notation
Birthday The birthday listed in Google profile
Login Time The Date and Time when the Google user had logged in
Location Name The name of the hotspot from where the user had logged in with his/her Google+ ID

Example

http://w1.wifi-soft.com/wifilan/json/getSocialData?cc=12345678&sd=2015-11-01&ed=2015-11-15&soc=facebook

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.