API DOCS

LOCALIZATION - COUNTRY BY BROWSER LANGUAGE / LOCALE

Choose the country of your customer based on their browser locale:

Required Credits: 1
Request
Example with a US locale
GET https://gender-api.com/get?name=john&locale=en_US&key=<your api key>
Request
Example with a German locale
GET https://gender-api.com/get?name=tanja&locale=de_DE&key=<your api key>
Field Type Description
name String Name to query
locale String Browser locale
key String Your API Key
Response
Example with a US locale
{"name":"john","name_sanitized":"John","country":"US","gender":"male","samples":991,"accuracy":99,"duration":"47ms","credits_used":1}
Response
Example with a German locale
{"name":"tanja","name_sanitized":"Tanja","country":"DE","gender":"female","samples":143,"accuracy":97,"duration":"99ms","credits_used":1}
Field Type Description
name String Submitted name in lower case
name_sanitized String The name after we applied our normalizer to it
country String Submitted country code
gender String Possible values: male, female, unknown
samples Integer Number of records found in our database which match your request
accuracy Integer This value determines the reliability of our database. A value of 100 means that the results on your gender request are 100% accurate
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.