NameAPI is a web API
to handle people's names
in your software.

News

14.04.2025

Dictionary Update: Kyrgyz Names Added

We’ve expanded our database with a rich collection of Kyrgyz names. This update includes 7,500...


31.03.2025

Dictionary Update: Urdu Names

Our growing graph name database now includes around 10,100 terms in Urdu script along with their...


28.03.2025

Maintenance Notice

We would like to inform you that during the course of today, we will be performing scheduled...


24.02.2025

Version 10.7.0 Released

Release of Optimaize PII Platform, version 10.7.0.


20.01.2025

2024 Around the World

2024 has been a pivotal year for Optimaize, with notable advancements in our software capabilities,...


   

Name Genderizer


       
Attempts to detect the person's gender based on the inputs, especially the person's name.
See also the Swagger specification.
                    
POST
       
application/json (you must set the content-type as http header)
       
We have integrated Swagger directly into our API.
Visit https://api.nameapi.org/rest/swagger-ui/.

   

Input

               
See Context.
   
{
  "context" : {
     "priority" : "REALTIME",
     "properties" : [ ]
   },
  "inputPerson" : {
    "type" : "NaturalInputPerson",
    "personName" : {
      "nameFields" : [ {
        "string" : "Andrea",
        "fieldType" : "GIVENNAME"
      }, {
        "string" : "Bocelli",
        "fieldType" : "SURNAME"
      } ]
    },
    "gender" : "UNKNOWN"
  }
}      
   

   

Output

       
Possible values:

The person is clearly 'male'.

The person is clearly 'female'.

Can be either male or female. See malePercent.

No gender could be computed, but better intelligence should be able to tell the gender. An example is a name input of which we have never heard before.

From the given data it is or seems impossible to tell the gender.
For example all terms are gender-inapplicable, or there are no names at all. Thus this differs from NEUTRAL where something is clearly known to be neutral.

There are conflicting genders in the given data.
Example: "Mr Daniela Miller" (salutation vs. given name).
The input data must be manually reviewed. It is impossible and useless to make a guess (garbage in would only cause garbage out).

       
If neutral (otherwise null) then this may be specified (but does not have to be), 0-1, the remaining % are for female.
       
0-1 where 1 is the best.
   
{
  "gender" : "MALE",
  "confidence" : 0.9111111111111111
}