Development — entry 058 of 98
Nationalize.io
Nationalize.io, the third API from Demografix ApS alongside Agify and Genderize, returns a ranked list of likely countries of origin (with probability scores) for a given first name, drawn from worldwide naming statistics, and supports batching up to 10 names per call. It requires no key for its free tier of 2,500 names a month, with paid plans scaling to 25 million requests a month.
Nationalize.io returns a ranked list of likely countries for a first name, drawn from worldwide naming statistics. Each candidate country gets a probability score. You can batch up to 100 names in one request. Keyless calls work for a quick test. For the free tier of 2,500 names a month, register for a free API key.
GreatAPIs Score
Embed this badge
<a href="https://greatapis.com/api/nationalize-io/"><img src="https://greatapis.com/badge/nationalize-io.svg" alt="Scored 85 on greatapis.com"></a>Auth quickstart
- No API key required for a quick test. Keyless requests are public.
- For more than a few calls, register at nationalize.io for a free key. The same key works on Genderize, Agify, and Nationalize.
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Predict likely countries from a first name
GEThttps://api.nationalize.io?name=nathaniel
{
"count": 57823,
"name": "nathaniel",
"country": [
{"country_id": "US", "probability": 0.357622},
{"country_id": "NG", "probability": 0.07579},
{"country_id": "PH", "probability": 0.069334},
{"country_id": "GH", "probability": 0.067883},
{"country_id": "GB", "probability": 0.054157}
]
}Developer reference
2,500 names/month (Free tier) -- per nationalize.io/documentation's pricing table; a live probe also showed a 25-per-window x-rate-limit-limit header on top of the monthly cap.
Gotchas & limits
countryalways returns up to five candidates, ordered by descending probability, and is an empty array rather than an error when no prediction can be made- Batch lookups use repeated
name[]params (e.g.?name[]=nguyen&name[]=schmidt&name[]=garcia), up to 100 names per request, and return a JSON array instead of a single object - Keyless calls carry
x-rate-limit-limit: 25with a multi-hour reset, per a live response header. The documented free tier of 2,500 names a month needs a free account key