Nationalize API

Name: Nationalize API
Brand: Nationalize API
Availability: InStock

✓ Official Vendor SpecData EnrichmentContact EnrichmentapiKey1 EndpointsREST

For Agents

Predict the most likely countries of origin for any first name and return ranked country codes with probability scores.

Install Jentic One Beta

Connect the Nationalize API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Nationalize API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Nationalize API.

Predict the country of origin for a single first name with probability scores

Run batch nationality predictions across up to 10 names per request

Return ISO 3166-1 alpha-2 country codes ranked by likelihood for downstream routing

GET STARTED

Start building with Nationalize API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Nationalize API for, with concrete tasks.

★ Lead Enrichment by Predicted Nationality

Sales and marketing teams often capture only a first name on a lead form yet still need a country signal to route the lead or personalise outreach. A single call to the Nationalize API returns ranked country codes with probability scores, letting downstream automation decide which sales region or language template to apply. Integration is a one-endpoint job and typically takes under an hour to wire into a CRM webhook.

Send a GET to / with name=Lukas and return the top country code along with its probability for use in lead routing.

Audience Segmentation in Marketing

Marketers running multi-region campaigns can group audiences by the predicted nationality of subscribers when explicit country fields are unreliable. The API supports up to ten name lookups per request, so list cleanup workflows can score a contact list at low cost. The output integrates cleanly into ESPs and customer data platforms as an enrichment column.

Pass ten subscriber first names to / and tag each contact in the ESP with the highest-probability country code returned.

Demographic Research and Analytics

Researchers and product analysts use Nationalize to study patterns in user names across product cohorts without requesting personal data from users. Aggregating predictions over a cohort gives a rough country distribution that informs internationalisation and product decisions, while staying within the privacy boundary of using only first names. The endpoint returns deterministic probabilities that can be cached for repeat lookups.

Iterate over a cohort of 500 first names, call / for each, and produce a histogram of predicted country codes.

Agent-Driven Contact Enrichment via Jentic

Agent assistants enriching contact records in a CRM need a quick nationality estimate without managing a Nationalize key directly. Through Jentic, the agent searches by intent and executes the single Nationalize operation against a name input, receiving country probabilities back as JSON. Jentic stores the API key and injects it at runtime, isolating the secret from the agent context.

Search Jentic for 'predict nationality from a first name', load the operation schema, and execute it with the lead's first name to populate a 'predicted_country' CRM field.

Key Endpoints

1 endpoints — the nationalize api predicts the most likely countries of origin for a given first name based on a probabilistic model trained on hundreds of millions of name-to-country pairings.

METHOD

PATH

DESCRIPTION

GET

Predict country of origin for one or more first names

GET

Predict country of origin for one or more first names

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Nationalize API key (when used) is stored in the Jentic vault and injected as the apikey query parameter at execution time. Agents call the operation through Jentic without seeing the raw key.

Intent-based discovery

Agents search Jentic by intent (e.g. 'predict nationality from a first name') and Jentic returns the single Nationalize operation with its input schema for direct execution.

Time to first call

Direct integration with Nationalize: a few hours including key handling, retries, and rate-limit logic. Through Jentic: under 15 minutes — search, load schema, execute.

FAQs

Specific to using Nationalize API through Jentic.

What authentication does the Nationalize API use?

The API uses an API key passed as the apikey query parameter. Free usage is available without a key up to a daily limit; paid plans require a key. Jentic stores the key in its vault and appends it at request time.

Can I predict the country for multiple names in one Nationalize API call?

Yes. The single GET / endpoint accepts up to 10 name parameters per request and returns a ranked country list with probability scores for each name in the response array.

What are the rate limits for the Nationalize API?

Free tier is capped at 100 requests per day across an IP. Paid plans on nationalize.io raise the daily quota and add commercial-use rights; the OpenAPI spec does not publish per-second limits.

How do I predict a name's country of origin through Jentic?

Run pip install jentic, search for 'predict nationality from a first name', load the schema for the / operation, and execute it with the name parameter. Sign up at https://app.jentic.com/sign-up to obtain an agent API key.

Does the Nationalize API return ISO country codes?

Yes. Each prediction in the response carries a country_id field containing the ISO 3166-1 alpha-2 code together with a probability score, suitable for direct use in routing or segmentation logic.