🏳️ Country Flags CDN Scraper

🚀 Export CC-BY country flag URLs in seconds. Pull 250+ country flags at 8 resolutions (w20 to w2560) with localized country names in 9 languages. CDN-hosted PNGs, no rate limits.

The Country Flags CDN Scraper queries the public FlagCDN catalog, the most widely used CC-BY licensed flag CDN online. It returns 7 structured fields per record, including the preview URL, ISO 3166-1 alpha-2 country code, localized country name, language code, the full flag URL set at the chosen resolutions, and the scrape timestamp.

The catalog covers 250+ countries and territories including all UN member states, dependencies, observer states (e.g. EU, XK), and select non-sovereign codes (e.g. UN). Eight raster resolutions (w20, w40, w80, w160, w320, w640, w1280, w2560) ship per country, plus localized country names in English, Spanish, French, German, Italian, Portuguese, Chinese, Japanese, and Korean. Downloadable as CSV, Excel, JSON, or XML.

🎯 Target Audience	💡 Primary Use Cases
Travel and booking platforms, edtech, dashboards, language-learning apps, news outlets, civic-tech, design systems, internationalized SaaS	Country picker dropdowns, dashboard country tiles, language-learning flashcards, travel-app country chips, news topic icons, internationalized email templates

📋 What the Country Flags CDN Scraper does

Two lookup workflows in a single run:

• 🖼️ Flag URLs mode. Per-country PNG URLs at every resolution you request, plus an ISO code and localized country name.
• 🌐 Codes mode. Compact reference: just the alpha-2 code and localized country name.
• 🌍 Localization. Country names are returned in your chosen language (en, es, fr, de, it, pt, zh, ja, ko).
• 🎯 Country filter. Optional alpha-2 list to scope the run to a subset of countries.
• 📐 Resolution picker. Choose any subset of the 8 supported widths.

Each record bundles the preview URL (defaults to w320), country code, localized name, language, the full URL set keyed by width, and the scrape timestamp.

💡 Why it matters: every country picker, every dashboard tile, every language flashcard app needs flag assets. Self-hosting means paying for storage and bandwidth, plus tracking flag-design updates. This Actor delivers a CC-BY URL set you can plug directly into any UI, with zero hosting cost.

📊 Data fields

Each record includes: countryCode, countryName, flagPreviewUrl, flagUrls, language, scrapedAt. These field names come straight from the actor's dataset schema, so what you see here is what lands in your dataset.

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the Country Flags CDN Scraper page on the Apify Store.
3. 🎯 Set input. Pick a mode, a language, an optional country filter, and the resolutions you need. Set maxItems.
4. 🚀 Run it. Click Start and let the Actor collect your data.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

🔗 Recommended Actors

• 🌐 Nominatim OSM Scraper - Geocode addresses via OpenStreetMap
• 🛬 OurAirports Global Airport Database Scraper - Global aviation reference dataset
• 💱 Frankfurter FX Rates Scraper - ECB-derived foreign-exchange rates
• 🏦 IBAN Bank Codes Scraper - IBAN structures and ISO country codes
• 📈 Indexmundi Scraper - Global demographic and economic indicators

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by FlagCDN or any flag-asset provider. All trademarks mentioned are the property of their respective owners. Only publicly available CC-BY licensed flag assets are referenced.

🆘 Need Help?

If you hit a bug, have questions about setup, or need a scraper we haven't built yet, open our contact form or write to parseforge@protonmail.com. We also take on paid custom data projects.

For faster answers, join our Discord. It's the best place to get support and suggest new actors.