Agify.io

How to Use This API

1. Predict Age from Name (Global)

https://api.agify.io/?name=bella

Returns: {"name":"bella","age":38,"count":11234}. The age is the median predicted age. count is the number of data points in the model.

2. Country-Specific Prediction

https://api.agify.io/?name=john&country_id=US

Add country code (ISO 3166-1 alpha-2) for localized predictions. John averages different ages in the US vs UK vs Germany.

3. Batch Prediction (Multiple Names)

https://api.agify.io/?name[]=michael&name[]=sarah&name[]=david

Predict multiple names in one request. Returns an array of results.

4. JavaScript — Age Guesser

async function predictAge(name, country = null) {
  const params = new URLSearchParams({ name });
  if (country) params.set('country_id', country);
  
  const resp = await fetch('https://api.agify.io/?' + params);
  return resp.json();
}

// Predict ages for a group
const names = ['alice', 'bob', 'charlie', 'diana'];
Promise.all(names.map(n => predictAge(n)))
  .then(results => {
    results.forEach(r =>
      console.log(`${r.name}: ~${r.age} years old (n=${r.count})`)
    );
  });

5. Python — Age Distribution View

import requests

def age_for_name(name, country=None):
    params = {'name': name}
    if country:
        params['country_id'] = country
    resp = requests.get('https://api.agify.io/', params=params)
    return resp.json()

# Compare across countries
for country in ['US', 'GB', 'DE', 'FR']:
    data = age_for_name('james', country)
    print(f"James in {country}: ~{data['age']} "
          f"(based on {data['count']} records)")

# Batch request
batch = requests.get(
    'https://api.agify.io/',
    params={'name[]': ['olivia', 'liam', 'noah', 'emma']}
).json()
for r in batch:
    print(f"{r['name']}: ~{r['age']}")