persons / getPopularSources
Use for: Get a list of popular sources that are active for the specified country
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)
Optional
format- The format the output has to be in
callback- Only for json, adds the given value as the callback
Example call url
http://persons.api.centroidmedia.com/getPopularSources?lang=nl&country=nl&api_key=[your api key]&api_sig=[api signature]&signature=[signature]Example response code
<source>
<name>Facebook</name>
<id>facebook</id>
<category>socialnetworks</category>
</source>
{
sources:
[
{
name: "Facebook",
id: "facebook",
category: "socialnetworks"
}
]
}
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.