Nationalize Name Origin Scraper
parseforge/nationalize-origin-scraper
AIDeveloper toolsLead generation
Queries the public Nationalize.io API for a list of first names and returns each country probability prediction as a flat row with the name, country code, probability, and sample count.
- Total users
- 2
- Monthly active
- 1
- Total runs
- 55
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
Nationalize Name Origin Scraper
Scrape name origin predictions for any list of first names. Get country probabilities, top country, and count per name in one flat row. No API key. Export to CSV, JSON, Excel, or XML.
Nationalize.io predicts the country of origin of a first name from public data, but its API limits you to 10 names per request and needs manual calls. This Actor reads the public prediction endpoint directly, takes a list of names, and returns each prediction as one row with country probabilities and counts. It handles batching and rate limits for you.
| Who uses it | What they scrape Nationalize for |
|---|---|
| Market researchers | Which countries a list of customer first names likely comes from |
| Data analysts | Enriching a name column with origin probabilities for segmentation |
| Sociologists | Studying naming patterns across regions from large name lists |
| CRM managers | Cleaning and standardizing name data with origin metadata |
What it does
This Actor collects name origin predictions from Nationalize.io for each name you provide, and returns each prediction as a flat row with country codes, probabilities, and counts.
- ๐ Country probabilities: each row includes the top predicted countries with their probability scores.
- ๐ Flat output: one row per name, easy to join with your existing dataset.
- ๐ Bulk input: paste a list of names, the Actor handles batching and rate limits.
- ๐ Multiple exports: download as CSV, JSON, Excel, or XML.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with Nationalize data
๐ Enrich customer data with origin probabilities.
A CRM manager runs a list of 5,000 customer first names through the Actor and joins the country probabilities to segment campaigns by likely region.
๐ Study naming trends across countries.
A sociologist feeds a list of baby names from a public dataset and uses the country probabilities to analyze cultural naming patterns.
๐งน Clean and standardize name fields.
A data analyst uses the origin predictions to flag names that are likely misspelled or from unexpected regions before merging datasets.
๐ Build a name origin dataset for research.
A market researcher collects predictions for a curated list of names and exports the flat rows to CSV for further statistical analysis.
Why choose this scraper
| What you get | |
|---|---|
| No API key | Uses the public Nationalize.io endpoint, no registration needed |
| Bulk names | Process hundreds or thousands of names in one run |
| Structured data | Each prediction is a flat row with country codes and probabilities |
| Export ready | Save results directly to CSV, JSON, Excel, or XML |
How it compares
No other Store actor targets Nationalize the same way, so the honest comparison is with the alternatives teams actually weigh.
| Nationalize Name Origin Scraper | Build it in-house | By hand | |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When Nationalize changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |
Configure the run
Drive the Actor with a list of first names, and set a maximum number of predictions to collect per run. The Input tab lists every parameter.
A first run with the defaults:
{
"names": [
"michael",
"sofia",
"wei"
],
"maxItems": 10
}
A larger pull:
{
"names": [
"michael",
"sofia",
"wei"
],
"maxItems": 200
}
Pricing
Pay-per-result: $0.005 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $0.50 |
| 1,000 results | $5.00 |
| 10,000 results | $50.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the Nationalize Name Origin Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to Nationalize through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/nationalize-origin-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check that you entered at least one name in the input. Also ensure the maximum predictions is set to at least 1. If the names are very rare, Nationalize.io may not have data.
Why are some country probabilities missing?
Nationalize.io returns only countries with a probability above a threshold. If a name is uncommon, the list may be short or empty.
The run is slow with many names.
The Actor batches requests to respect rate limits. For very large lists, consider splitting into multiple runs or increasing the timeout in advanced settings.
I get an error about invalid input.
Make sure the 'names' field is a list of strings, not a single string. In the input editor, add one name per line.
FAQ
| Question | Answer |
|---|---|
| What is Nationalize.io? | Nationalize.io is a free public API that predicts the country of origin of a first name based on statistical data. It returns a list of countries with probabilities. |
| Do I need an API key? | No. This Actor uses the public endpoint of Nationalize.io, which does not require an API key or registration. |
| How many names can I process in one run? | You can provide any number of names in the input list. The Actor batches requests automatically and respects rate limits. You can also set a maximum number of predictions to collect. |
| What does the output look like? | Each name becomes one row in the dataset. The row includes the name, the top predicted country, and a list of country codes with their probabilities and counts. |
| Can I export the results? | Yes. You can download the results as CSV, JSON, Excel, or XML directly from the Apify dataset. |
| Is the data accurate? | Nationalize.io provides statistical predictions based on public name data. Accuracy varies by name and region, but it is useful for aggregate analysis. |
| Can I use this for commercial purposes? | The Nationalize.io API is free for non-commercial use. Check their terms for commercial use. This Actor does not add any restrictions. |
| What if a name is not found? | If Nationalize.io has no data for a name, the prediction may be empty or have low probabilities. The Actor still returns a row with the name and empty fields. |
| How do I run this Actor? | In the Apify console, click 'Try for free', enter your list of names in the input, set the maximum predictions, and run. You can also schedule it via API. |
| Can I integrate this with my own app? | Yes. You can call the Actor via the Apify API and get results in JSON, or use webhooks to trigger downstream processing. |
Related actors
Browse the full ParseForge collection for more scrapers.
๐ Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
โ ๏ธ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Nationalize.io. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| names required | array | First names to look up. Add one entry per name (for example Michael, Sofia, Wei). | ["michael","sofia","wei"] |
| maxItems | integer | How many predictions to collect per run. | 10 |
Pricing
from $4.52 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.00452 to $0.005 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~nationalize-origin-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.
