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