llms.txt Content
# Nationalize.io
> Nationalize.io is a REST API that predicts the nationality of a person from their first name, returning an array of countries with probability scores. It is operated by Demografix ApS (Denmark) and is part of a suite of three name-based demographic APIs.
Nationalize.io bases its predictions on a dataset of over 908 million data rows covering 240+ countries and territories. The API is used for demographic analysis, localization, market research, and academic research.
Important: Nationalize.io predicts nationality (country of origin), not ethnicity. The API returns ISO 3166-1 alpha-2 country codes (e.g., "US", "GB", "DK") with probability scores. It returns multiple possible countries ranked by likelihood, not a single definitive answer.
## API
- [API Documentation](https://nationalize.io/documentation): Full API reference with request/response formats, parameters, error codes, and examples
- [Example request](https://api.nationalize.io?name=peter): `GET https://api.nationalize.io?name=peter` returns `{"count":121222,"name":"peter","country":[{"country_id":"NG","probability":0.078},{"country_id":"KE","probability":0.046},{"country_id":"UG","probability":0.043}, ...]}`
- [Batch requests](https://nationalize.io/documentation): Up to 10 names per request using `name[]=` parameter. Each name counts as one lookup against your quota.
- [Our Data](https://nationalize.io/our-data): Details on dataset size and country coverage
Note: Nationalize.io does not support the `country_id` localization parameter — localization is not applicable because the API's purpose is to predict country of origin.
## Pricing
- [Pricing](https://nationalize.io/pricing): All tiers include access to all three APIs (genderize.io, agify.io, nationalize.io).
- Free: 100 names/day, no API key required
- Basic: 25,000 names/month — $20/month
- Standard: 250,000 names/month — $60/month
- Plus: 2,500,000 names/month — $180/month
- Premium: 25,000,000 names/month — $540/