How to hit the Agify, Genderize, Nationalize API

Three sibling APIs estimate a person's age, gender, or nationality from a first name, based on public data. Each returns a count of how many data points the guess rests on.

Authentication

None for light use — the free tier has a daily limit. A paid apikey parameter raises it.

Full reference: https://agify.io/

Predict age

curl "https://api.agify.io?name=michael"
Run in PostTaco
Example response (trimmed)
{
  "count": 311558,
  "name": "michael",
  "age": 57
}

Predict gender

probability is how confident the guess is.

curl "https://api.genderize.io?name=peter"
Run in PostTaco
Example response (trimmed)
{
  "count": 1352696,
  "name": "peter",
  "gender": "male",
  "probability": 1
}

Predict nationality

Up to five countries, most likely first.

curl "https://api.nationalize.io?name=nathaniel"
Run in PostTaco
Example response (trimmed)
{
  "count": 57823,
  "name": "nathaniel",
  "country": [
    {
      "country_id": "US",
      "probability": 0.357622
    },
    {
      "country_id": "NG",
      "probability": 0.07579
    }
  ]
}

Narrow by country

country_id scopes the guess to one country's data.

curl "https://api.agify.io?name=michael&country_id=US"
Run in PostTaco
Example response (trimmed)
{
  "count": 110111,
  "name": "michael",
  "age": 52,
  "country_id": "US"
}