persons / search

Use for: Search for a person

Authentication

This method requires authentication.

Arguments

Required

api_key: Your API application key. See here for more details.
api_sig: Your API signature. See here for more details.
country: The country where you want to search in (options: nl,gb,fr,be,de,se,dk,pl,ru,es,us,it)
signature: The signature that is used to create the api_sig
lang: The language you want to search in (options: nl,en,fr,de,se,dk,pl,ru,es,it)
categories: The categories you want to use
firstname: The firstname you want to search for
fullname: The fullname you want to search for
sources: Which sources to use for searching
set: Which set to use for searching (can be popular or all, popular is the default)

Required arguments marked with a red star are part of a group. This means that only one argument of a group is required to make a call. The number of stars identifies a different group.

Optional

format: The format the output has to be in
callback: Only for json, adds the given value as the callback
lastname: The lastname you want to search for

Example call url

http://persons.api.centroidmedia.com/search?lang=nl&country=nl&api_key=[your api key]&api_sig=[api signature]&signature=[signature]&fullname=John+Doe&sources=facebook

    <source>
        <name>Facebook</name>
        <id>facebook</id>
        <category>socialnetworks</category>
        <found>10</found>
        <result_location>http://whoozy.com/api/facebook?firstname=John&lastname=Doe</result_location>
        <results>
            <result>
                <photo>http://profile.ak.fbcdn.net/v229/1183/31/q1450911178_1710.jpg</photo>
                <url>http://www.facebook.com/people/John-Doe/1450911178</url>
                <name>John Doe</name>
            </result>
        </results>
    </source>

{
    sources: 
    [
        {
            name: "Facebook",
            id: "facebook",
            category: "socialnetworks",
            found: 10,
            result_location: "http://whoozy.com/api/facebook?firstname=John&lastname=Doe"
        }
    ]
}

This is the standard result of our API. It gives back one result per source id. The paid version of our API returns every result and also an URL for more results at the source. For more info about paid accounts contact us.

Example response code for paid accounts

XML
JSON

    <source>
        <name>Facebook</name>
        <id>facebook</id>
        <category>socialnetworks</category>
        <found>10</found>
        <result_location>http://whoozy.com/api/facebook?firstname=John&lastname=Doe</result_location>
        <more_results_url>http://www.facebook.com/srch.php?nm=John+Doe</more_results_url>
        <results>
            <result>
                <photo>http://profile.ak.fbcdn.net/v229/1183/31/q1450911178_1710.jpg</photo>
                <url>http://www.facebook.com/people/John-Doe/1450911178</url>
                <name>John Doe</name>
            </result>
            .
            .
            .
            .
            .
            .
            .
            .
            <result>
                <photo>http://profile.ak.fbcdn.net/v224/929/31/q575693423_7743.jpg</photo>
                <url>http://www.facebook.com/people/John-Doe/575693423</url>
                <name>John Doe</name>
            </result>
        </results>
    </source>

{
    sources: 
    [
        {
            name: "Facebook",
            id: "facebook",
            category: "socialnetworks",
            found: 10,
            result_location: "http://whoozy.com/api/facebook?firstname=John&lastname=Doe",
            more_results_url: "http://www.facebook.com/srch.php?nm=John+Doe",
            results: 
            [
                {
                    photo: "http://profile.ak.fbcdn.net/v229/1183/31/q1450911178_1710.jpg",
                    url: "http://www.facebook.com/people/John-Doe/1450911178",
                    name: "John Doe"
                },
                .
                .
                .
                .
                .
                .
                .
                .
                {
                    photo: "http://profile.ak.fbcdn.net/v229/1183/31/q1450911178_1710.jpg",
                    url: "http://www.facebook.com/people/John-Doe/1450911178",
                    name: "John Doe"
                }
            ]
        }
    ]
}

For more info about paid accounts contact us.

Error codes

1: Invalid API key: The API key that was provided is invalid
2: Invalid API signature: The API signature that was provided is invalid
4: Invalid country: The country that was provided is invalid
6: Rate limit exceeded: Your Application made to many calls and is therefore blocked
7: Invalid language: The language that was provided is invalid
8: API signature was not unique: The API signature that was provided, was already used by the API key. Every time a call is made, the signature has to be unique.
21: Please specify a firstname or fullname: There was no firstname or fullname provided
22: Please specify a set, a category or a source: There was no set, category or source provided

About Centroid API

API Methods