One API To
Rule Them All

Api Version 1.1

sociotoco.profiles.getProfiles

With the sociotoco.profiles.getProfiles method you can retrieve profiles with a given first and/or last name and network. The profiles are sorted on relevance. The first profile is the most relevant profile.

Authentication
This method requires authentication.

Arguments

Required

An API Key (key)
A Signature (sig)
A Unix Timestamp (time)
A NetworkID (nid)
A First Name (f)
A Last Name (l)

Optional

A Middle Name (m)

Example Request

GET /services/1.1/rest?method=sociotoco.profiles.getProfiles&key=[your_key]&f=[first_name]&m=[middle_name]&l[last_name]&nid=[networkid]&time=[unix_timestamp]&sig=[signature] HTTP/1.1

Example Response

XML
JSON

<?xml version="1.0" encoding="utf-8"?>
<response>
   <profile id="F3ED1ED29D7">
      <network id="6">Twitter</network>
      <name>Arno Ham</name>
      <location>Schiedam, Netherlands</location>
      <imageUrl>http://www.sociotoco.com/services/image?pid=F3ED1ED29D7</imageUrl>
      <sources>
         <source>Google</source>
         <source>Bing</source>
      </sources>
      <fields>
       <description>Manager Software Development at ISM eCompany (Arno 1.0) 
returned from a World Trip!</description>
       <followers>76</followers>
       <friends>74</friends>
       <updates>182</updates>
       <timeZone>Amsterdam</timeZone>
      </fields>
   </profile>
   <profile id="C0DCEBAA30F9">
      <network id="6">Twitter</network>
      <name>Jurgen Appelo</name>
      <location />
      <imageUrl>http://www.sociotoco.com/services/image?pid=C0DCEBAA30F9</imageUrl>
      <sources>
         <source>Yahoo</source>
      </sources>
      <fields>
       <description>agile writer, speaker, developer, entrepreneur, manager, 
blogger, reader, dreamer, leader, freethinker, and… Dutch guy</description>
       <followers>2119</followers>
       <friends>20</friends>
       <updates>7297</updates>
       <timeZone>Amsterdam</timeZone>
      </fields>
   </profile>
</response>

{
   "response":{
      "profiles":[
         {
            "id":"F3ED1ED29D7",
            "network":{
               "id":6,
               "name":"Twitter"
            },
            "name":"Arno Ham",
            "location":"Schiedam, The Netherlands",
            "imageUrl":"http://www.sociotococ.com/Service/Api/image?pid=F3ED1ED29D7",
            "sources":[
               "Google",
               "Bing",
            ],
            "fields":{
               "description":"Manager Software Development at ISM eCompany (Arno 1.0) 
returned from a World Trip!",
               "followers":"76",
               "friends":"74",
               "updates":"182",
               "timeZone":"Amsterdam"
            }
         },
         {
            "id":"C0DCEBAA30F9",
            "network":{
               "id":6,
               "name":"Twitter"
            },
            "name":"Jurgen Appelo",
            "location":"Rotterdam, The Netherlands",
            "imageUrl":"http://www.sociotoco.com/Service/Api/image?pid=C0DCEBAA30F9",
            "sources":[
               "Yahoo"
            ],
             "fields":{
               "description":"agile writer, speaker, developer, entrepreneur, 
manager, blogger, reader, dreamer, leader, freethinker, and… Dutch guy",
               "followers":"2119",
               "friends":"20",
               "updates":"7297",
               "timeZone":"Amsterdam"
            }
         }
      ]
   }
}

Error codes

100	KeyMissing There is no key argument in the query string.
101	SignatureMissing There is no sig argument in the query string.
200	KeyInvalid There is an invalid key argument in the query string.
201	KeyNotFound The key is not found as a registered api key.
210	SignatureInvalid The supplied signature in the query string is invalid.
220	MethodNotSupported The supplied method in the query string is not supported.
300	NetworkIdMissing There is no networkId argument in the query string.
302	FirstNameMissing There is no first name argument in the query string.
303	LastNameMissing There is no last name argument in the query string.
400	NetworkInvalid The given networkId is invalid. It should be an integer.
401	NetworkNotSupported There is no network found with the given networkId.

One API To Rule Them All

Api Version 1.1

sociotoco.profiles.getProfiles

One API To
Rule Them All