API DOCS
SPLIT FIRST AND LAST NAME
If you use a combined field for first and last name on your page, use this API to extract the parts:
GET https://gender-api.com/get?split=theresa%20miller&key=<your api key>
GET https://gender-api.com/get?split=tim%20johnson&country=US&key=<your api key>
GET https://gender-api.com/get?split=markus%20stefan%20nonExistingLastName&strict=true&key=<your api key>
Field | Type | Description |
---|---|---|
split | String | Full name |
country | String | ISO 3166 ALPHA-2 Country Code |
strict | Boolean (true|false) | When the strict mode is enabled, we will return null in the last_name field if the last_name cannot be found in our database. When the strict mode is disabled, we will try to extract the last name even if it cannot be found in our database |
key | String | Your API Key |
{"last_name":"Miller","first_name":"Theresa","strict":false,"name":"theresa","name_sanitized":"Theresa","country":"","gender":"female","samples":70,"accuracy":74,"duration":"56ms","credits_used":1}
{"last_name":"Johnson","first_name":"Tim","strict":false,"name":"tim","name_sanitized":"Tim","country":"US","gender":"male","samples":7,"accuracy":100,"duration":"58ms","credits_used":1}
{"last_name":"","first_name":"Markus Stefan","strict":true,"name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"85ms","credits_used":1}
Field | Type | Description |
---|---|---|
last_name | String | The last name found |
first_name | String | The first name found |
strict | Boolean | True if the strict mode is enabled |
name | String | First Name found in lowercase |
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 |
Please indicate your customers enter their names in the form "First Name, Last Name", which makes our response more accurate.