Agify API reference

The Agify API allows you to estimate the age of a person based on their first name.

The API exposes a single endpoint that accepts a name and returns a payload with the prediction. It uses query parameters for requests and returns JSON-encoded responses.

The API is free for up to 100 names/day. No sign-up or API key is needed. So go ahead and try it out. You can sign up for an API key if you need more requests.

We support batch processing to reduce the overhead of many HTTP calls.

The endpoint also supports localization, allowing you to scope the gender prediction to a single country for higher accuracy.

The API is built for high-volume processing, and as such, there is no rate limiting except your daily or monthly limit. You can keep track of that through rate-limiting headers or your account.

For basic usage you just need to pass a name as the name parameter. It's recommended to always use a first name if you have it available. If not, the API will attempt to parse the input as a full name and pick out the first name.

The response includes the estimated age, and a count. The probability which indicates the amount of data rows examined for the response. You can read more about our data here.

It's worth noting that demographics can influence naming conventions, so check out how to scope for a specific country.

The API is free to use for up to 100 requests/day. If you need to do more predictions than that, you can obtain an API key from the store.

You should append the key to every request using the apikey parameter.

To keep track of the number of requests you have left for a given period, you can use the following HTTP headers returned in the response. If you're using an API key, you can also check your account to keep track of your usage.

Naming conventions can rely heavily on demographics, so specifying a country for the lookup will, in many cases, make the prediction better.

The API accepts an optional country_id parameter. The API will return a prediction specifically for the provided country when used. We recommend using it whenever you have the data available.

The dataset might be smaller for some countries, so it is worth checking the count and redoing the request globally if it's too low.

The service follows ISO 3166-1 alpha-2 for country codes. See our list of supported countries to understand the coverage for each country.

The API allows you to estimate the age of up to ten names per request. To do so, send a list of names as the name parameter. The response will be a list of predictions.

Using localization on a batch request will apply the given country_id to every name in the batch.

Each name will count as a request towards rate limiting. If you don't have enough requests to process every name, an error will be returned.