API DOCS

QUERY MULTIPLE NAMES

Sometimes it is necessary to fetch multiple names with one query:

Request
Without country code
GET /get?name=lisa;jess;thomas&multi=true&key=<your private server key>
Request
With country code
GET /get?name=anna;jack;stephen&country=DE;US;CA&multi=true&key=<your private server key>
Field Type Description
name String Semicolon separated list of names to query
country String Semicolon separated list of country codes. The country codes must be in the same order as the names. If only one country code is provided this code will be used for all names.
multi Boolean (true|false) Tells the API to return the result as an array
key String Your private server key
Response
Without country code
{"name":"lisa;jess;thomas","result":[
{"name":"lisa","name_sanitized":"Lisa","country":"","gender":"female","samples":806,"accuracy":98},
{"name":"jess","name_sanitized":"Jess","country":"","gender":"female","samples":28,"accuracy":75},
{"name":"thomas","name_sanitized":"Thomas","country":"","gender":"male","samples":2239,"accuracy":99}],
"country":"","duration":"425ms","credits_used":3}
Response
With country code
{"name":"anna;jack;stephen","result":[
{"name":"anna","name_sanitized":"Anna","country":"DE","gender":"female","samples":1245,"accuracy":98},
{"name":"jack","name_sanitized":"Jack","country":"US","gender":"male","samples":667,"accuracy":90},
{"name":"stephen","name_sanitized":"Stephen","country":"CA","gender":"male","samples":77,"accuracy":82}],
"country":"DE;US;CA","duration":"668ms","credits_used":3}
Field Type Description
name String Submitted names in lower case. The maximum number of names is limited to 100.
result Array See response under "Simple Usage"
country String Submitted list of country codes
duration String Time the server needed to process the request
credits_used Integer The amount of credits used for this query

Please note: If multiple names are requested in one query, each name will be counted as a single request.

We use cookies to ensure that we give you the best experience on our website. If you continue to use this site we will assume that you are happy with it.
Got it