⚡ Unified API v2.0 ADVANCED

API Docs Unified API v2.0

Experience our high-performance unified API designed for advanced users with high request volumes. Query multiple names in a single request with lightning-fast response times.

API v1.0 SIMPLE

We also offer another API version with endpoints that are easier to integrate. If you're a beginner in implementing API's you can switch to our v1.0 endpoint.

View API v1.0 →

🚀 API Tools

Explore our API using industry-standard tools

View Swagger Docs → Import to Postman →

Query By First Name

Query By Full Name

Query By Email Address

Get Country Of Origin

Get Stats

Error Codes

Query by full name - 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:

POST

info Required Requests: 1

link URL

https://gender-api.com/v2/gender

http Headers

Content-Type: application/json

Authorization: Bearer <your authorization token>

link

data_object JSON Payload

Field	Type	Required	Description
`full_name`	string	Yes	Name to query
`country`	string	No	ISO 3166 ALPHA-2 Country Code link
`locale`	string	No	Browser Locale
`ip`	string	No	Valid IPv4 or IPv6 address
`id`	string	No	Max 50 chars. You can set this id to any alphanumeric value you want. As an example, you can set the id to your internal id of the dataset in your database. In an asynchronus environment this can help you to better connect the response to a previous request

code Examples

Query by full name only

play_arrow Test live with codepen.io

{
    "full_name": "Theresa Miller"
}

Query by full name and country code

play_arrow Test live with codepen.io

{
    "full_name": "Theresa Miller",
    "country": "US"
}

Query by full name and browser locale

play_arrow Test live with codepen.io

{
    "full_name": "Thomas Johnson",
    "locale": "en_US"
}

Query by full name and use an IP address for localization

play_arrow Test live with codepen.io

{
    "full_name": "Markus Stefan NonExistingLastName",
    "ip": "54.201.16.177"
}

Query multiple names in a single request

play_arrow Test live with codepen.io

[
    {
        "full_name": "Theresa Miller"
    },
    {
        "full_name": "Thomas Johnson",
        "country": "US"
    }
]

check_circle Response

{
    "input": {
        "full_name": "Theresa Miller"
    },
    "details": {
    "credits_used": 1,
        "duration": "33ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

list Response Fields

Field	Type	Description
`input`	object	The submitted payload
`details.credits_used`	int	The amount of requests used for this query
`details.samples`	int	Number of records found in our database which match your request
`details.country`	string	The country we found
`details.full_name_sanitized`	int	The name after we applied our normalizer to it
`details.duration`	string	Time the server needed to process the request
`result_found`	bool	True if we were able to query a gender for the given name
`full_name`	string	The full name we used for genderization
`probability`	float	This value (between 0 and 1) determines the reliability of our database. A value of 1 means that the results on your gender request are 100% accurate.
`gender`	string	Possible values: male, female, unknown