# 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/month
- Yearly billing available (pay for 10 months, get 12)

## Tools

- [CSV Upload Tool](https://nationalize.io/tools/csv): Upload a CSV file and get gender, age, and nationality columns added — no code required
- [No-Code Integrations](https://nationalize.io/tools/no-code): Official integrations with Make (formerly Integromat), Zapier, and Pipedream
- [Community Libraries](https://nationalize.io/libraries): Open-source libraries for Python, R, PHP, Ruby, Go, JavaScript, Java, C#, and more

## Resources

- [FAQ](https://nationalize.io/faq): Common questions about data accuracy, billing, rate limits, and methodology
- [Case Studies](https://nationalize.io/case-studies): Use cases in demographic analysis and research

## Related APIs

- [Genderize.io](https://genderize.io): Predict gender from a name — same subscription, same API key
- [Agify.io](https://agify.io): Predict age from a name — same subscription, same API key