nationalize

n8n community node for Nationalize.io API - predict nationality based on names with probability scores

Package Information

Released: 6 mo ago
Downloads: 9 weekly / 58 monthly
Latest Version: 1.0.1
Author: Demografix

Available Nodes

Documentation generating…

Nationalize icon
Nationalize
Get nationality prediction for a given name using the Nationalize.io API (free tier: 2,500 requests/month)

Documentation

@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

  1. Sign up at nationalize.io
  2. Copy your API key from the dashboard
  3. In n8n, create new "Nationalize API" credentials
  4. Paste the API key
  5. 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

  1. Add the "Nationalize" node to your workflow
  2. Enter a name (e.g., "Johnson", "Bakshi", "Nguyen") — last name is preferred
  3. Execute the node

Response Data

The node returns the following data:

  • name: The name that was queried
  • count: Number of data samples used for this prediction
  • country: 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 period
  • rateLimit.remaining: Requests remaining in current period
  • rateLimit.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 rateLimit data to monitor your API usage and avoid hitting limits
  • Country codes follow the ISO 3166-1 alpha-2 standard

Resources

Discussion