oanor
Sign up free
Marketplace Pricing Features Sign in

API · /flags-api

Flags API

healthy 4,250 Subscribers

National flag design as an API — built on the classic UCI "Flags" dataset (194 countries) and enriched with each country's ISO 3166-1 alpha-2 code, its Unicode flag emoji and ready-to-use SVG / PNG image URLs. For each flag the API exposes its real design attributes: the number of vertical bars and horizontal stripes, the colours present, the predominant ("main") hue, the colours of the top-left and bottom-right corners, and which symbols appear — circles, crosses, saltires, quartered fields, stars or suns, a crescent, a triangle, an inanimate icon (e.g. an anchor), an animate image (e.g. an eagle) or written text. Look a flag up by country or code, search, or FILTER flags by colour, main hue or symbol — "every flag with a crescent", "flags that are mainly green". Served from memory — always fast.

#flags #countries #emoji #vexillology #reference #education
api.oanor.com/flags-api
Get an API key Try in playground → Contact provider

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

/api/flags-api/openapi.json
/api/flags-api/llms.txt

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

Flags API — live data on the oanor API marketplace

API health

healthy
Uptime
100.00%
Server probes · 24h
Avg latency
79 ms
Server probes · 24h
Subscribers
4,250
active
Total calls
95
last 7 days
status Full status page → · 15 probes/24h

Pricing

Pick a tier — billed monthly, cancel anytime.

Free

Free

  • 25,000 calls / month
  • 3 requests / second
  • Hard cap (429 above quota, no overage)
  • 25k calls/month
  • 3 req/sec
  • All endpoints
  • No credit card
Sign in to subscribe

Starter

€5.00 /month

  • 250,000 calls / month
  • 10 requests / second
  • Hard cap (429 above quota, no overage)
  • 250k calls/month
  • 10 req/sec
  • Email support
Sign in to subscribe

Pro

€12.00 /month

  • 1,200,000 calls / month
  • 25 requests / second
  • Hard cap (429 above quota, no overage)
  • 1.2M calls/month
  • 25 req/sec
  • Priority support
Sign in to subscribe

Mega

€30.00 /month

  • 6,000,000 calls / month
  • 60 requests / second
  • Hard cap (429 above quota, no overage)
  • 6M calls/month
  • 60 req/sec
  • Dedicated SLA
Sign in to subscribe

Built by

P
PremiumApi

Related APIs

Other APIs with overlapping tags.

Countries API — oanor API marketplace

Countries API

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.

api.oanor.com/countries-api

 IMF Economic Data API — oanor API marketplace

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 — oanor API marketplace

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 — oanor API marketplace

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

Frequently asked questions

Quick answers about pricing, quotas, and integration.

How do I get an API key for Flags API?
Sign up for free at oanor.com, generate an API key from the developer dashboard, and call Flags API with the x-oanor-key header. No credit card needed for the free tier.
What's the rate limit for Flags 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 Flags API cost?
Flags 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 Flags API GDPR-compliant?
All requests to Flags 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.

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

Code snippets

Sign up to get an API key, then call any path under your slug.

curl https://api.oanor.com/flags-api/SOME_PATH \
  -H "x-oanor-key: oanor_test_..."
const res = await fetch("https://api.oanor.com/flags-api/SOME_PATH", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();
$ch = curl_init("https://api.oanor.com/flags-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/flags-api/SOME_PATH",
    headers={"x-oanor-key": "oanor_test_..."},
)
print(r.json())

Ratings

Sign in to rate.

No reviews yet.

Discussion

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

Sign in to start a thread or reply.

Sign in

New thread

/ 4000

📌 Pinned 🔒 Locked

·

· ·

/ 4000

🔒 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.

Sign in to open a support ticket.

Sign in

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.