API DOCS

QUERY MULTIPLE NAMES

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

Required Credits: 1 credit for each name
Request
Without country code
GET https://gender-api.com/get?name=lisa;jess;thomas&multi=true&key=<your private server key>
Request
With country code
GET https://gender-api.com/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
We use cookies and similar technologies to recognize your repeat visits and preferences, as well as to measure the effectiveness of campaigns and analyze traffic.
You can learn more about which cookies we use or edit them here.