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.

API health

healthy
Uptime
100.00%
Server probes · 24h
Avg latency
89 ms
Server probes · 24h
Subscribers
4,250
active
Total calls
35
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

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

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