GET login/users/:user id/profile
From Social ID Developers
Revision as of 21:53, 12 November 2014 by Gabriel.prado (Talk | contribs)
Contents |
Description
Returns the user profile (complete or partial). The user profile is built with all social networks the user has associated to his account.
Resource URL
GET https://api.socialidnow.com/v1/marketing/login/users/:user_id/profile
Parameters
URL Parameters
user_id | required | user identifier. |
---|---|---|
fields | optional | a list of user profile field names to be returned, joined by commas. See Social Profile Fields. Default: all fields are returned. |
refresh | optional | whether the profile should be refreshed at the moment of the request. Default: false. Notice: this API call may take longer if this parameter is set to true due to the social network latency. |
Authentication
This API requires Marketing Account authentication. See Authentication.
Response
The response returns the Social Profile Fields or only the ones required by the parameters "fields".
Examples
Without fields
Request
Returns all profile fields of user "340".
curl -X GET 'https://api.socialidnow.com/v1/marketing/login/users/340/profile' \ --user <api_id>:<api_secret>
Response
Response Body
{ "about_me": "Software Engineer", "addresses": [ { "country":"br", "formatted":"Campinas, SP, Brasil", "locality":null, "postal_code":null, "region":null, "street_address":null } ], "birthday": "1980-10-01", "certifications":[], "courses":[], "current_location": "Campinas, SP, Brasil", "display_name": "John Doe", "educations": [ { "degree": "null", "description": null, "end_date": null, "name": "Universidade Estadual de Campinas", "start_date": null, "type": "Graduate School" } ], "emails": [ { "primary": true, "type": "other", "value": "john.doe@somedomain.com" } ], "gender": "male", "hometown": "San Francisco, CA", "honors": null, "ims": [ ], "industry": null, "interested_in_meeting": [ ], "interests": [ { "category": "Interest", "link": "http://www.facebook.com/pages/Conference-on-Computer-Vision-and-Pattern-Recognition/137428412945882", "name": "Conference on Computer Vision and Pattern Recognition" } ], "languages_spoken": [ { "level": null, "name": "Portuguese" } ], "likes": [ { "category": "Product/service", "link": "http://www.facebook.com/coffeebeantech", "name": "Coffee Bean Technology" } ], "locale": "en", "name": { "family_name": null, "formatted": "John Doe", "given_name": null, "honorific_prefix": null, "honorific_suffix": null, "middle_name": null }, "nickname": null, "organizations": [ { "department": null, "description": null, "end_date": "2006-01-01", "location": "São Paulo, SP", "name": "Coffee Bean Technology", "primary": false, "start_date": "2001-01-01", "title": "Software Developer", "type": null } ], "phone_numbers": [ ], "picture_url": "http://somedomain.com/johndoe.jpg", "political_views": null, "preferred_username": "johndoe", "professional_headline": null, "profile_url": null, "providers": { "facebook": { "id": "12345", "picture_url": "https://www.facebook.com/johndoe", "profile_url": "https://www.facebook.com/johndoe.png", "username": "johndoe" }, "twitter": { "id": "456", "picture_url": "https://www.twitter.com/johndoe", "profile_url": "https://www.twitter.com/johndoe.png", "username": "johndoe" }, "linkedin": { "id": "http://www.linkedin.com/in/johndoe", "picture_url": "http://www.linkedin.com/in/johndoe.png", "profile_url": "http://www.linkedin.com/in/johndoe" }, "gplus": { "id": "456", "picture_url": "https://plus.google.com/johndoe", "profile_url": "https://plus.google.com/johndoe.png", "username": "johndoe" } }, "quotes": [ ], "relationship_status": "married", "religion": null, "significant_other": null, "specialties": null, "status": null, "updated": "2012-12-22T01:27:13Z", "urls": [ { "primary": false, "type": null, "value": "http://somedomain.com/johndoe" } ], "utc_offset": "-10800", "verified_account": "f", "verified_email": "john.doe@somedomain.com" }
With fields
Request
Returns current_location, display_name and verified_email profile fields of user "340".
curl -X GET 'https://api.socialidnow.com/v1/marketing/login/users/340/profile?fields=display_name,verified_email,current_location' \ --user <api_id>:<api_secret>
Response
Response Body
{ "current_location": "Campinas, SP, Brasil", "display_name": "John Doe", "verified_email": "john.doe@somedomain.com" }