One API To
Rule Them All

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

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 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.
Sociotoco is an ISM eCompany business unit. © 2009-2010. All rights reserved.