API · /countries-api

Countries API

healthy 4,526 Subscribers

Reference data for all 250 countries and territories — capitals, ISO codes (alpha-2/alpha-3), currencies, languages, flags, population, area, borders, calling codes and more. Look up by name, ISO code, region, currency or language.

#countries #geography #reference #flags #currencies #languages #iso #borders

api.oanor.com/countries-api

Get an API key Try in playground → Contact provider

Machine-readable spec so AI agents can integrate this API.

/api/countries-api/openapi.json

/api/countries-api/llms.txt

Discovery: GET /api/index.json lists every API.

Countries API — live data on the oanor API marketplace

API health

healthy

Uptime: 100.00%; Server probes · 24h
Avg latency: 85 ms; Server probes · 24h
Subscribers: 4,526; active
Total calls: 114; last 7 days

Full status page → · 18 probes/24h

Pricing

Pick a tier — billed monthly, cancel anytime.

Free

25,000 calls / month
5 requests / second
Hard cap (429 above quota, no overage)
25k calls/month
5 req/sec
All endpoints
No credit card

Basic

€5.00 /month

150,000 calls / month
15 requests / second
Hard cap (429 above quota, no overage)
150k calls/month
15 req/sec
Email support

Pro

€15.00 /month

750,000 calls / month
30 requests / second
Hard cap (429 above quota, no overage)
750k calls/month
30 req/sec
Priority support

Mega

€39.00 /month

3,000,000 calls / month
60 requests / second
Hard cap (429 above quota, no overage)
3M calls/month
60 req/sec
Dedicated SLA

Built by

PremiumApi

Related APIs

Other APIs with overlapping tags.

IMF Economic Data API

Live macroeconomic data from the International Monetary Fund's World Economic Outlook — the official cross-country numbers, served from the public IMF DataMapper, no key, nothing stored. GDP, real GDP growth, inflation, gross government debt, unemployment, the current-account balance, GDP per capita and 120-plus other indicators for 200-plus countries, with the IMF's historical record back to 1980 and its forecasts several years into the future. The indicators endpoint lists every series the IMF publishes, with an optional search. The series endpoint returns one indicator's full time series for one country — every year, actual and projected. The country endpoint returns a snapshot of a country's headline numbers — real GDP growth, inflation, government debt as a share of GDP, unemployment, current-account balance and GDP per capita — across recent and forecast years. Compare economies, track the debt and growth outlook and pull the same numbers policymakers use, as live JSON. This is the IMF macro / economic-indicator cut — distinct from the FX-rate, central-bank and market-data APIs in the catalogue.

api.oanor.com/imf-api

Olympic Medals API

The all-time Olympic medal table as an API — cumulative Summer and Winter Olympic results for every National Olympic Committee. For each country: its NOC code and, split into Summer / Winter / Combined, the number of Games attended and the gold, silver, bronze and total medals won. Look a country up by name or NOC code, rank countries by any medal metric (all-time gold, winter gold, totals and more), or search. A stable sports reference for quiz, media, sports and data-viz apps. Distinct from single-Games results.

api.oanor.com/olympicmedals-api

Gini Index (Income Inequality) API

Income-inequality data for every country as an API — the World Bank Gini index, the standard measure of how evenly income is distributed. The coefficient runs from 0 (perfect equality) to 100 (one person holds all income); a higher number means a more unequal society. For each of 170+ countries the API returns the latest available value, the full year-by-year history and the all-time minimum and maximum, enriched with the ISO 3166-1 alpha-2 code and flag emoji. Look a country up by name or code, RANK countries by their latest inequality (the most or least equal in the world), search, or list them all. The reference an economics dashboard, data-journalism piece or research tool needs. Distinct from countrystats-api (area, population, life expectancy) — this is the inequality series specifically, with per-country history. Served from memory — always fast.

api.oanor.com/gini-api

Country Statistics API

Geographic, demographic and political statistics for every country as an API — the reference a research dashboard, data-journalism piece or analytics tool needs. For each country: its government type, whether it is landlocked, surface area (km²), population, population density (people/km²) and life expectancy (years), enriched with the ISO 3166-1 alpha-2 code and flag emoji. Look a country up by name or code, or RANK every country by any numeric statistic — the ten largest by area, the most densely populated, the highest life expectancy — in ascending or descending order. Search by name or government type, or list them all. This is the country statistics reference — distinct from countries-api (ISO identifiers: codes, dialing, currency, region) and disease-api (public-health data). Served from memory — always fast.

api.oanor.com/countrystats-api

Frequently asked questions

Quick answers about pricing, quotas, and integration.

How do I get an API key for Countries API?

Sign up for free at oanor.com, generate an API key from the developer dashboard, and call Countries API with the x-oanor-key header. No credit card needed for the free tier.

What's the rate limit for Countries API?

Free tier allows 1 request per second. Paid plans scale up to 50 requests per second on the Mega tier. Hard limits return HTTP 429 above the quota — no surprise overage charges.

How much does Countries API cost?

Countries API has a free tier with 100 calls / month. Paid plans start at €5.00 / month with higher quotas and faster rate limits.

Can I cancel my subscription anytime?

Yes. Plans are billed monthly and you can cancel anytime from your billing dashboard. No long-term contracts and no cancellation fee.

Is Countries API GDPR-compliant?

All requests to Countries API go through our EU-based gateway. Your upstream API key never leaves our server and no personal data is shared with the upstream provider beyond the request you send.

Countries 3

Lists 3

Pick an endpoint from the list on the left to see its details and try it.

GET /v1/all

All countries (summary)

Parameters

Custom headers

Language: Client:

Code snippets

curl https://api.oanor.com/countries-api/SOME_PATH \
  -H "x-oanor-key: oanor_test_..."

const res = await fetch("https://api.oanor.com/countries-api/SOME_PATH", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();

$ch = curl_init("https://api.oanor.com/countries-api/SOME_PATH");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
$response = curl_exec($ch);

import requests
r = requests.get(
    "https://api.oanor.com/countries-api/SOME_PATH",
    headers={"x-oanor-key": "oanor_test_..."},
)
print(r.json())

Ratings

No reviews yet.

Discussion

Ask questions, share usage tips, get answers from the provider and other developers. Public — anyone can read.

New thread

📌 Pinned 🔒 Locked

· ·

🔒 This thread is locked — no new replies.

No threads yet — start the discussion.

Support

Private 1:1 support with the provider — billing questions, integration issues, account problems. Only you and the provider team can see these threads.

Open new ticket

Describe what you need help with. The provider team gets an email and replies on the ticket page.

No tickets yet for this API.

Subscription active — calls can start immediately.

Send your first request —

Subscription active — copy a snippet and fire off your first call.

Pick a key

Plaintext is shown once at creation — use the prefix as a reminder.

Countries API

API health

Pricing

Built by

Related APIs

IMF Economic Data API

Olympic Medals API

Gini Index (Income Inequality) API

Country Statistics API

Frequently asked questions

Parameters

Parameters

Parameters

Parameters

Parameters

Code snippets

Ratings

Discussion

New thread

📌 🔒

Support

Open new ticket

Your cookie choices