API · /cities-api

World Cities API

healthy 3,371 Subscribers

Search a database of 33,000+ cities worldwide (population 15,000+) from GeoNames. Find cities by name, country and minimum population, look up a city by id, or find all cities near a coordinate (radius search). Each city includes coordinates, region, population, timezone and elevation — ideal for autocompletes, location pickers, store locators and geo dashboards.

api.oanor.com/cities-api
Get an API key Try in playground → Contact provider

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

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

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

API health

healthy
Uptime
100.00%
Server probes · 24h
Avg latency
83 ms
Server probes · 24h
Subscribers
3,371
active
Total calls
432
last 7 days
status Full status page → · 20 probes/24h

Pricing

Pick a tier — billed monthly, cancel anytime.

Free

Free

  • 5,000 calls / month
  • 3 requests / second
  • Hard cap (429 above quota, no overage)
  • 5,000 calls/month
  • 3 req/sec
  • Search + nearby + lookup
  • No credit card
Sign in to subscribe

Starter

€7.00 /month

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

Pro

€19.00 /month

  • 1,250,000 calls / month
  • 40 requests / second
  • Hard cap (429 above quota, no overage)
  • 1.25M calls/month
  • 40 req/sec
  • Autocomplete / radius search
  • Priority support
Sign in to subscribe

Mega

€52.00 /month

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

Built by

Related APIs

Other APIs with overlapping tags.

Gene Expression API

Functional-genomics experiments as an API — powered by NCBI GEO (Gene Expression Omnibus), the largest public repository of gene-expression data. GEO archives expression series and curated datasets from microarray and high-throughput-sequencing experiments across every organism. Search experiments by keyword and optionally by organism, and look up any series or dataset to get its metadata: title, summary, assay type (expression profiling by array or by sequencing), organism, number of samples, platform and the publication behind it. From β-cell stress studies to cancer transcriptomics across human and mouse, it turns the GEO archive into a simple search-and-fetch API for transcriptomics, bioinformatics and research-data discovery. A gene-expression / functional-genomics dataset repository — distinct from sequence (ENA), variant (ClinVar, dbVar), structure (PDB) and ontology databases. Open data from NCBI GEO (public domain).

api.oanor.com/geodatasets-api

Country Subdivisions API

Look up the administrative subdivisions of any country — 5,300+ states, provinces, regions and districts across 229 countries, with ISO 3166-2 codes. Search by name, country or type, fetch all subdivisions of a country (perfect for address-form dropdowns), or resolve an ISO 3166-2 code like US-CA to its name, type and coordinates. Bundled, fast and always available.

api.oanor.com/regions-api

Earthquake API

Real-time and historical earthquake data sourced from the USGS Earthquake Hazards Program. Pull ready-made summary feeds by magnitude band and period (significant, M4.5+, M2.5+, M1.0+ or all, over the past hour, day, week or month), run a full FDSN search by time window, magnitude range and geographic radius, count matching events, fetch the latest quakes worldwide, or look up a single event by its USGS id. Every event comes as a clean record with magnitude and type, place, ISO timestamps, depth and coordinates, felt reports, shaking intensity (CDI/MMI), PAGER alert level, tsunami flag and significance. Authoritative public data delivered through a fast, reliable API — ideal for insurance and risk, IoT and sensor alerting, newsrooms, research and disaster-response apps.

api.oanor.com/earthquake-api

Geo Distance API

A fast, fully-local great-circle geospatial toolkit: compute the haversine distance between two coordinates (in km, m, miles or nautical miles), the initial and final compass bearing, the geographic midpoint, the destination point reached from an origin on a bearing at a given distance, and a bounding box around a center for a radius. Pure server-side compute, no third-party upstream, so responses are instant and always available. Ideal for logistics, delivery and fleet apps, store locators, real-estate search, travel and mapping tools.

api.oanor.com/geo-api

Frequently asked questions

Quick answers about pricing, quotas, and integration.

How do I get an API key for World Cities API?
Sign up for free at oanor.com, generate an API key from the developer dashboard, and call World Cities API with the x-oanor-key header. No credit card needed for the free tier.
What's the rate limit for World Cities 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 World Cities API cost?
World Cities API has a free tier with 100 calls / month. Paid plans start at €7.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 World Cities API GDPR-compliant?
All requests to World Cities 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/cities-api/SOME_PATH \
  -H "x-oanor-key: oanor_test_..."
const res = await fetch("https://api.oanor.com/cities-api/SOME_PATH", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();
$ch = curl_init("https://api.oanor.com/cities-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/cities-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.