@demografix/n8n-nodes-nationalize
v1.0.1
Published
n8n community node for Nationalize.io API - predict nationality based on names with probability scores
Maintainers
Readme
@demografix/n8n-nodes-nationalize
This is an n8n community node. It lets you use Nationalize.io in your n8n workflows.
Nationalize.io is a nationality prediction API that estimates the most likely countries of origin for a given name based on statistical analysis.
n8n is a fair-code licensed workflow automation platform.
Installation Operations Credentials Compatibility Usage Resources
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
- Get Nationality: Predict the most likely countries of origin for a given name, ranked by probability
Credentials
An API key is required for all Nationalize.io requests.
Free tier — 2,500 requests/month
Sign up at nationalize.io for a free account. Free accounts include 2,500 requests per month at no cost.
Paid tiers
For higher volumes, subscribe to a paid plan at nationalize.io — tiers cover increased monthly request quotas.
Setup
- Sign up at nationalize.io
- Copy your API key from the dashboard
- In n8n, create new "Nationalize API" credentials
- Paste the API key
- Test the credentials to verify they work
Compatibility
This node is built using n8n's declarative style and requires n8n version 1.0 or later.
Usage
Basic Example
- Add the "Nationalize" node to your workflow
- Enter a name (e.g., "Johnson", "Bakshi", "Nguyen") — last name is preferred
- Execute the node
Response Data
The node returns the following data:
name: The name that was queriedcount: Number of data samples used for this predictioncountry: Array of up to 5 country predictions, each with:country_id: ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "DK")probability: Confidence score (0–1, where 1 is 100% confident)
rateLimit.limit: Total requests allowed in current periodrateLimit.remaining: Requests remaining in current periodrateLimit.reset: Seconds until the rate limit window resets
Tips
- The API attempts to parse full names and extract the last name automatically
- Diacritics are normalised before matching
- Use the
rateLimitdata to monitor your API usage and avoid hitting limits - Country codes follow the ISO 3166-1 alpha-2 standard
