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:
Required Credits: 1
Request
Without country code
GET https://gender-api.com/get?split=theresa%20miller&key=<your api key>Request
With country code
GET https://gender-api.com/get?split=tim%20johnson&country=US&key=<your api key>Request
Strict mode on
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 |
Response
Without country code
{"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}Response
With country code
{"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}Response
Strict mode on
{"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.
