Country data API: ISO codes, capital, region and population

$0.01 per call · failed calls are never charged · no account or subscription: pay per call with a card key or USDC

Facts about a country by ISO code (SE, SWE, US…): official World Bank name, ISO-2 and ISO-3 codes, region, income level, capital city and its coordinates, and the latest population figure with its year (World Bank open data). Use to enrich records with country data.

When to use it

Enrich records with country data by ISO code (SE, SWE, US)
Get the capital city and its coordinates
Read the latest population figure with its year and the income level

Run it free (25 free calls) Buy credits by card (from $1) Example result (JSON)

Inputs

Name	Type	Description
`country` (required)	string	ISO 3166 alpha-2 or alpha-3 code

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://tools.funwords.eu/country?country=SE"

Or one of your 25 free calls, no key:

curl "https://tools.funwords.eu/country?country=SE&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.

Example result

{
  "name": "Sweden",
  "iso2": "SE",
  "iso3": "SWE",
  "region": "Europe & Central Asia",
  "incomeLevel": "High income",
  "capital": "Stockholm",
  "capitalLat": 59.3327,
  "capitalLon": 18.0645,
  "population": 10596620,
  "populationYear": 2025,
  "source": "World Bank"
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is country, and the first 25 successful calls are free:

https://tools.funwords.eu/mcp

Questions

Where does the data come from?

World Bank open data, with the official World Bank name and region.

How do I pay?

Each successful call costs $0.01; failed calls are not charged. The first 25 calls are free. Then pay with card credits (from $1; the key goes in an Authorization header or, for clients that can only fetch a URL, as api_key= in the URL) or per call in USDC over x402 or MPP. No account is needed.