API DOCS

LOCALIZATION - COUNTRY BY BROWSER LANGUAGE / LOCALE

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

Request
Example with a US locale
GET https://gender-api.com/get?name=john&locale=en_US&key=<your private server key>
Request
Example with a German locale
GET https://gender-api.com/get?name=tanja&locale=de_DE&key=<your private server key>
Field Type Description
name String Name to query
locale String Browser locale
key String Your private server 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

Gender-API.com includes GeoLite2 data created by MaxMind, available from http://www.maxmind.com.

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