Skip to main content
Countries API is a public, read-only JSON service in the REST Countries tradition, plus a separate flag CDN. There are no API keys or sign-up. Cross-origin requests are allowed.

Quickstart

Copy a curl, project fields, and paginate five countries at a time.

API playground

Try every /v1 and flag route against the live OpenAPI spec.

Flag CDN

Resolve ISO codes to PNG or SVG via 301 redirects to hashed files.

For agents

Start at /llms.txt. Full contract lives at /openapi.json.

​
What you get

  • Country records with names, ISO codes, currencies, languages, region, Wikidata enrichment (economics, development, government, and more), and computed metrics.
  • flags.svg and flags.png URLs on every full record.
  • REST Countries–style filters: alpha, name, capital, region, language, currency, independence.
  • Capped list pages (max 5) instead of a bulk /all dump.
Free public serviceOperated by Surf Online. Commercial use is allowed under the Terms of Service. We may throttle or block abusive traffic.