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 api key>
Request
With country code
GET https://gender-api.com/get?name=anna;jack;stephen&country=DE;US;CA&multi=true&key=<your api 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 API 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
Chat

Cookies

We use cookies (including third-party cookies) to collect information about visitors' use of our website. These cookies help us to provide you with the best possible online experience and to constantly improve our websites. Information collected via cookies may also be processed outside the European Union, for example, in the USA. By clicking the "Accept All" button, you agree to the use of cookies. To withdraw your consent at any time, change your settings or for more information about the use of cookies, click here or "Cookie Settings" at the end of the page.