FlagCDN Emoji Lookup Scraper

FlagCDN Emoji Lookup Scraper

Scrape FlagCDN emoji country codes and names from the official codes.json API. Get every ISO country code mapped to its country name in one flat dataset. No login, no API key, no browser. Export to CSV, JSON, Excel, or XML.

FlagCDN publishes a public codes.json endpoint that maps ISO country codes to country names, but there is no official download page or bulk export tool. This Actor reads that endpoint directly and returns every mapping as a clean row. It is the fastest way to get the full FlagCDN emoji country code list into your own dataset.

Who uses it	What they scrape FlagCDN for
Frontend developers	Build a country flag emoji picker without hardcoding the ISO code list
Data analysts	Get a clean country code to country name reference table for joins
Localization teams	Verify which ISO country codes FlagCDN supports before integrating
Indie hackers	Seed a country selector or flag emoji component with real data

What it does

This Actor collects the complete FlagCDN emoji country code mapping from the official codes.json API and returns each ISO code and country name as a flat row.

• 🌍 Full country list: every ISO country code and country name from the official FlagCDN codes.json endpoint.
• ⚡ One API call: the Actor hits the verified endpoint once and returns the complete mapping, no pagination needed.
• 📦 Flat row output: each result is a single row with the ISO code and country name, ready for CSV, JSON, Excel, or XML export.
• 🔢 Max items control: set maxItems to limit the preview or pull the full list up to 1,000,000 rows for paid users.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with FlagCDN data

🌍 Build a flag emoji picker.

A frontend developer runs the Actor once to get the full FlagCDN emoji country code list, then feeds the ISO codes into a country selector component.

📊 Create a country reference table.

A data analyst scrapes the FlagCDN emoji JSON to build a clean ISO code to country name lookup table for joining with other datasets.

🧪 Verify FlagCDN coverage.

A localization engineer runs the Actor to check which ISO country codes FlagCDN supports before committing to the service.

🛠️ Seed a side project.

An indie hacker pulls the FlagCDN emoji database to populate a country dropdown or flag emoji feature without writing a scraper from scratch.

Why choose this scraper

	What you get
No API key	The FlagCDN codes.json endpoint is public, so you can start scraping immediately
Official source	Data comes straight from the verified FlagCDN API, not a third party mirror
One flat schema	Every row has the same ISO code and country name fields, no nested JSON to flatten
Bulk export ready	Output goes directly to CSV, JSON, Excel, or XML for your pipeline

What a FlagCDN record looks like

Every record returns as one flat JSON row. Here is a real one from a run:

{
 "isoCode": "ad",
 "countryName": "Andorra",
 "flagUrl": "https://flagcdn.com/w40/ad.png",
 "flagEmoji": "🇦🇩"
}

Every value above comes from a real run. A field a record does not have comes back as null.

Configure the run

Drive the Actor with a single maxItems setting. Free users get a 10 item preview, paid users can pull the full FlagCDN emoji country code list up to 1,000,000 rows. The Input tab lists every parameter.

A first run with the defaults:

{
 "maxItems": 10
}

A larger pull:

{
 "maxItems": 200
}

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

1. Create a free Apify account.
2. Open the FlagCDN Emoji Lookup Scraper.
3. Set your inputs and any filters, then click Start.
4. 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 FlagCDN 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=acquistion-automation/flagcdn-emoji-lookup-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting only 10 items?

Free users are limited to a 10 item preview. Upgrade to a paid plan and set maxItems higher to pull the full FlagCDN emoji country code list.

Why is my run returning no results?

Check that maxItems is set to at least 1. The FlagCDN endpoint is public and stable, so an empty result usually means the input was set to zero or the run failed before the API call.

Can I get the flag emoji characters themselves?

No. This Actor returns the ISO country code and country name mapping. Flag emoji characters are rendered from the ISO codes by your application, not stored in the codes.json data.

Why does the output have only two fields?

The FlagCDN codes.json endpoint only contains ISO country codes and country names. That is the complete data available from this source.

FAQ

Question	Answer
What does the FlagCDN emoji lookup scraper return?	It returns every ISO country code mapped to its country name from the official FlagCDN codes.json endpoint. Each row has isoCode, countryName, flagUrl, and flagEmoji.
Do I need an API key for FlagCDN?	No. The codes.json endpoint is public and requires no authentication. The Actor reads it directly.
How many items can I scrape?	Free users get a 10 item preview. Paid users can set maxItems up to 1,000,000, which covers the full FlagCDN country code list many times over.
Is this the same data as the FlagCDN website?	Yes. The Actor calls the verified https://flagcdn.com/en/codes.json endpoint, which is the same source the FlagCDN site uses for its country flag emoji data.
What export formats are supported?	You can export the results to CSV, JSON, Excel, or XML directly from the Apify dataset.
Does this Actor scrape flag images?	No. It scrapes the ISO country code to country name mapping only. Flag images are served separately by FlagCDN and are not part of this Actor's output.
How often is the FlagCDN data updated?	The Actor reads the live codes.json endpoint on every run, so you always get the current mapping from FlagCDN.
Can I filter by country name or ISO code?	The Actor returns the full list. You can filter the exported dataset in your own pipeline or use maxItems to limit the preview size.

Related actors

Browse the full Acquisition Automation collection for more scrapers.

🆘 Need help? Open an issue in the Issues tab of this Actor with your run ID, your input, and what you expected.

Pricing

This Actor uses pay-per-result pricing: $0.00529 per result collected. You are billed only for the results you receive, so a run that returns nothing costs nothing.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by FlagCDN. 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.