🌐 Country Economic Data API: World Bank GDP, FX & Holidays

One call, four official sources, one brief. Give an ISO-2 country code (or many) and get a single structured market brief per country — basics, key economic indicators, FX rates, and upcoming public holidays — instead of making your agent stitch the World Bank, an FX API, and a holiday API together.

Headless · keyless (no API keys to manage) · structured JSON out · built for AI agents.

⚡ Why it's different

Other actors give you raw World Bank data, raw FX, or raw holidays. This one fuses them into one agent-ready brief: ask "ES", get Spain's income level, GDP/capita, growth, inflation, unemployment, EUR-per-USD, and the next holidays — in a single call.

📋 What you get (per country)

Field	Meaning
name, country, capital, region, incomeLevel	Country basics (World Bank)
latitude, longitude	Country centroid
indicators.gdpPerCapitaUsd	GDP per capita (current US$) + year
indicators.population	Total population + year
indicators.gdpGrowthPct	Real GDP growth % + year
indicators.inflationPct	Consumer-price inflation % + year
indicators.unemploymentPct	Unemployment % + year
fx.localCurrency + fx.localPerBase	Local currency and its rate vs your base
fx.majors	Base → USD/EUR/GBP/JPY/CNY
upcomingHolidays	Next N public holidays (date + name + local name)

📥 Input

Field	Type	Meaning
country	string	A single ISO-2 code, e.g. ES, US, JP
countries	array	Many codes: ["ES","JP","US"] (billed per country)
baseCurrency	string	FX base (default USD)
holidaysCount	integer	Upcoming holidays per country (default 5)
webhookUrl	string	POST the briefs here (Zapier/Make/n8n/custom)

Example input

{ "countries": ["ES", "JP", "US"], "baseCurrency": "USD", "holidaysCount": 5 }

📤 Output (one row per country)

{
  "country": "ES", "name": "Spain", "capital": "Madrid",
  "region": "Europe & Central Asia", "incomeLevel": "High income",
  "latitude": 40.41, "longitude": -3.70,
  "indicators": {
    "gdpPerCapitaUsd": { "value": 38627.25, "year": "2025" },
    "population": { "value": 49355143, "year": "2025" },
    "gdpGrowthPct": { "value": 2.82, "year": "2025" },
    "inflationPct": { "value": 2.67, "year": "2025" },
    "unemploymentPct": { "value": 10.38, "year": "2025" }
  },
  "fx": { "base": "USD", "localCurrency": "EUR", "localPerBase": 0.8926,
          "majors": { "USD": 1, "EUR": 0.8926, "GBP": 0.7459, "JPY": 158.23, "CNY": 7.12 },
          "updated": "Mon, 12 Oct 2026 ..." },
  "upcomingHolidays": [ { "date": "2026-10-12", "name": "National Day of Spain", "localName": "Fiesta Nacional de España" } ],
  "sources": ["worldbank.org", "open.er-api.com", "date.nager.at"],
  "capturedAt": "2026-..."
}

💡 Use cases

• Market research agents: one call for a country snapshot instead of three integrations.
• Travel / scheduling tools: economy + currency + the next public holidays in one place.
• Logistics / ops: compare several markets (GDP/inflation/unemployment) side by side.
• Localization / pricing: local currency + FX to set region-appropriate prices.
• Dashboards: seed a country table with fresh indicators + FX on a schedule.

🤖 For AI agents (MCP)

Keyless, one call → a fused, structured brief. Every input is described in the schema for programmatic/MCP use. Example MCP server config:

{
  "mcpServers": {
    "country-brief": {
      "url": "https://mcp.apify.com/?tools=actors,docs,centorprat/world-bank-country-economic-data"
    }
  }
}

Claude Code: claude mcp add --transport http apify "https://mcp.apify.com/?tools=actors,docs,centorprat/world-bank-country-economic-data" --header "Authorization: Bearer <YOUR_APIFY_TOKEN>"

No extra setup: this Actor is callable from Claude, Cursor, ChatGPT or any MCP client through the Apify MCP server, and agents can find it on their own with the server's search-actors tool.

🚀 Ready-made tasks (one click)

Pre-configured runs for the most common jobs. Open one, change the input, run:

• GDP, Inflation & Unemployment by Country: World Bank GDP, GDP per capita, growth, inflation, unemployment and population for any countries, plus FX rate. Structured, keyless.
• Upcoming Public Holidays by Country: Next public holidays for any list of countries, with dates and names, plus key economic indicators per country. Keyless holiday API.
• Currency Exchange Rate by Country: Live exchange rate of any country's currency vs USD, EUR or another base, with GDP, inflation and population. Keyless FX API.

❓ FAQ

• Do I need an API key? No — all sources are keyless and free; you only pay the Actor's per-country fee.
• How fresh is it? FX updates daily; indicators are the most recent year the World Bank publishes.
• Which countries? Any with an ISO-2 code; indicators depend on World Bank coverage (some small states are sparse).
• What if an indicator is missing? The field returns value: null — the brief still composes.
• Can I change the FX base? Yes — baseCurrency (e.g. EUR, GBP).
• How many countries per run? As many as you pass; billed per country.
• Why ISO-2 codes (not names)? Codes are unambiguous and agent-friendly (ES not "Spain/España").
• Is the data stored? No — fetched, composed, returned.
• Commercial use? Yes — World Bank open data, ECB-derived FX (open.er-api), and Nager public-holiday data are all free to use.

📜 Data & attribution

Country data & indicators from the World Bank (open data); exchange rates from open.er-api.com (ECB-sourced); public holidays from date.nager.at. Public data, composed and returned; nothing stored.

🔗 Related actors

Part of one suite of keyless, agent-ready composers by the same developer:

• Shopify Store Leads + App Audit (Reviews, Email, Pixels): Shopify stores by niche, verified and audited for missing apps (reviews, email/SMS, upsell, loyalty, chat, subscriptions), pixels and theme: scored leads with emails.
• Google Maps Leads + Website Audit for Agencies: local businesses from Google Maps audited for website, Google profile, reviews, booking and tracking gaps: scored, explained leads with phone and emails.
• FEMA Flood Zone & Property Risk API - Zillow/Redfin Enricher: FEMA flood zone + 18-hazard FEMA risk index + neighborhood demographics per US address, or for a whole Zillow/Redfin dataset.
• Domain Lookup API - DNS, MX, SPF, Tech & Contact Emails: DNS + live homepage → IPs, MX/SPF, tech, socials and public contacts per domain.
• Wikipedia & Wikidata API - Entity Facts, Summary & Pageviews: Wikipedia + Wikidata + pageviews → one structured brief per company, person or place.
• Weather, Air Quality & Earthquake Risk API by Location: live weather + air quality + earthquakes → one clear/caution/hazard verdict per point, worldwide.
• Aircraft Tracker API (ADS-B) - Approach & Military Alerts: aircraft approaching a point with CPA/ETA + military/unidentified flags and alerts.
• NARA Catalog Extractor: US National Archives catalog search → digital-object download URLs + metadata.