Genderine.com

The "get gender by firstname" API

  • For developpers
  • 100 % free
  • Simple & easy


USAGE.


Get the gender of one firstname

GET http://genderine.com/api/v1/?q=FIRSNAME

Exemple JSON response :
{
  "status":"OK",
  "data":{
    "firstname":"Ivana",
    "gender":"female",   // Possible values : male, female, both, unknown
    "frequency":4.025    // Greater frequency is, greater the gender match is.
  }
}


Get the gender of multiple firstnames (Limit of 1000 firstnames per quey)

GET http://genderine.com/api/v1/?q=COMA_SEPARTED_LIST_OF_FIRSNAMES

Exemple JSON response :
{   "status":"OK",
  "data":{
    "genders":{
      "Ivana":"female",
      "Jo\ufffdl":"unknown",
      "jason":"male"
    },
    "frequencies":{
      "Ivana":4.025,
      "Jo\ufffdl":0,
      "jason":1.587
    }
  }
}

Errors statuses.


Response Status Description
EMPTY_QUERY Nothing to get. Must provide not empty string.
MAX_NAMES_PER_QUERY_IS_1000 Query exceeds the maximum number of firstname by query

Genderine.com is a trademark of Pyxweb Inc.