Geographic Data + Live Rates & IP Geo. One API.
250+ countries, 150K+ cities, timezones, live currency rates in 25 base currencies (USD, EUR, GBP, and more), and IP geolocation — everything geographic your app needs, in one API. No stitching providers together.
Free plan forever. First 14 days: full access to cities, exchange rates, and IP geolocation.
$ curl api.apogeoapi.com/v1/countries/AR
{
"name": "Argentina",
"capital": "Buenos Aires",
"region": "South America",
"population": 45376763,
"currencyRate": {
"rate": 1048.50,
"base": "USD"
}
}$ curl api.apogeoapi.com/v1/countries/AR?base=EUR
{
"name": "Argentina",
"capital": "Buenos Aires",
"currency": "ARS",
"timezones": ["America/Argentina/Buenos_Aires"],
"latitude": -34.0, "longitude": -64.0,
"currencyRate": {
"rate": 1140.20,
"base": "EUR",
"lastUpdated": "2026-03-11T10:00:00Z"
}
}What's in the API
Six data types. One API key.
Countries, states, cities, timezones, multi-currency exchange rates (25 base currencies), and IP geolocation — everything your app needs, without stitching together multiple providers.
Countries
250+ countries with capitals, population, flags, phone codes, and 40+ fields per country.
States & Cities
5,000+ states and 150,000+ cities. Each with coordinates, admin codes, and population when available.
Timezones
Current UTC offsets, DST transitions, and IANA identifiers. Tied to coordinates, not just country.
Live Exchange Rates · 25 Base Currencies
Exchange rates for 161+ currencies with 25 selectable base currencies (USD, EUR, GBP, JPY, and more). Add ?base=EUR and get rates relative to the euro. Updated every 4 hours, inline in every response.
Languages
Official and spoken languages per country. ISO 639 codes included.
IP Geolocation
Geolocate any IPv4 or IPv6 address — country, region, city, timezone, and coordinates. Local MaxMind database, zero latency overhead.
How it works under the hood
Under 50ms median
Redis-cached responses. Cold queries under 200ms.
TLS 1.3 + hashed API keys
Keys stored as bcrypt hashes. HMAC-signed webhooks.
Consistent JSON everywhere
Predictable response shapes. Pagination on every list endpoint.
Data synced weekly
From government databases and ISO standards. Last update visible in the dashboard.
Webhooks on paid plans
Get notified on data changes and quota thresholds. SHA-256 signed payloads.
Usage analytics built in
Per-endpoint breakdown, response times, and cache hit rates in your dashboard.
Use ApogeoAPI in Claude & AI Assistants
The official Model Context Protocol server lets Claude Desktop, Cursor, and any MCP-compatible AI call our geographic endpoints as native tools — no custom code, no copy-pasting JSON. Ask “What is the USD rate for Brazil right now?” and the AI fetches live data directly.
- 8 tools: countries, states, cities, currency rates, IP geo, search
- Works with Claude Desktop, Cursor, and any MCP host
- Install in 30 seconds with npx — no build step required
claude_desktop_config.json
{
"mcpServers": {
"apogeoapi": {
"command": "npx",
"args": ["-y", "@apogeoapi/mcp"],
"env": {
"APOGEOAPI_KEY": "apogeoapi_live_xxx"
}
}
}
}Live API Demo
See the API in Action
Explore REST API endpoints with real responses. Clean JSON format, consistent structure, comprehensive data.
Endpoints
https://api.apogeoapi.com/v1/api/geo/countries/AR{
"id": 11,
"name": "Argentina",
"iso2": "AR",
"iso3": "ARG",
"capital": "Buenos Aires",
"region": "Americas",
"subregion": "South America",
"population": 45376763,
"currency": "ARS",
"currencyName": "Argentine peso",
"currencySymbol": "$",
"phoneCode": "+54",
"emoji": "🇦🇷",
"flagUrl": "https://flagcdn.com/ar.svg",
"timezones": ["America/Argentina/Buenos_Aires"],
"currencyRate": {
"rate": 1048.50,
"base": "USD",
"lastUpdated": "2026-03-11T10:00:00Z"
}
}Ready to integrate? Check out the documentation or get your free API key.
Documentation
Standard REST API. No SDK required. Works with any HTTP client in any language.
Authentication
Pass your API key via the X-API-Key header. Keys are hashed with bcrypt at rest. You can also use JWT Bearer tokens from the dashboard.
Endpoints
Countries, states, cities, timezones, currencies, languages, and geocoding. Every list endpoint supports pagination, filtering, and sorting.
Error handling
Standard HTTP status codes (400, 401, 404, 429, 500). Every error response includes a machine-readable code and a human-readable message.
Rate limits & quotas
Per-minute rate limits and monthly quotas depend on your plan. Every response includes X-RateLimit-Remaining and X-Monthly-Quota-Remaining headers.
# Get a country (default: USD rates)
curl -H "X-API-Key: your_key" \
https://api.apogeoapi.com/v1/countries/AR
# Get exchange rate in EUR (25 base currencies)
curl -H "X-API-Key: your_key" \
"https://api.apogeoapi.com/v1/countries/AR/currency-rate?base=EUR"
# List countries with GBP-based rates
curl -H "X-API-Key: your_key" \
"https://api.apogeoapi.com/v1/countries?base=GBP"
# Geolocate an IP address
curl -H "X-API-Key: your_key" \
"https://api.apogeoapi.com/v1/ip/190.130.45.1"What you can build
A few examples. The API is generic enough for anything that touches geographic data.
E-commerce shipping
Auto-fill country, state, and city dropdowns in checkout. Calculate shipping zones from coordinates. Show prices in local currency.
Travel apps
Display destination info, local time, and currency. Find nearby cities. Geocode hotel addresses for map pins.
Analytics dashboards
Resolve country codes into full profiles. Group users by region, timezone, or language for reporting.
CRM and onboarding
Validate and enrich addresses during sign-up. Auto-detect timezone for scheduling. Pre-fill phone country codes.
Location-based search
Find cities within a radius. Sort results by distance. Power "near me" features without a full mapping service.
Scheduling tools
Convert between timezones accurately, including DST transitions. Show meeting times in each participant's local time.
Pricing
Free forever with countries and states. Every new account gets 14 days of full access to cities, exchange rates, IP geolocation, and more — no credit card required. Upgrade anytime to keep premium features.
Free
Countries & states — forever free. 14-day full access on signup.
- 1,000 requests/month
- 5 requests/min
- 1 API key
- 7 days analytics
- Webhooks
- Countries data (250+ countries)
- States & provinces (5,000+)
- Cities (150,000+)14-day trial
- Global search14-day trial
- Live currency rates (25 base currencies)14-day trial
- IP geolocation14-day trial
- Community support
Basic
For small apps and personal projects
- 15,000 requests/month
- 30 requests/min
- 2 API keys
- 14 days analytics
- Webhooks
- Countries data (250+ countries)
- States & provinces (5,000+)
- Cities (150,000+)
- Global search
- Live currency rates (25 base currencies)
- IP geolocation
- Email 72h
- 99% SLA
Starter
For growing apps
- 100,000 requests/month
- 60 requests/min
- 3 API keys
- 30 days analytics
- Webhooks
- Countries data (250+ countries)
- States & provinces (5,000+)
- Cities (150,000+)
- Global search
- Live currency rates (25 base currencies)
- IP geolocation
- Email support (48h)
- 99% SLA
Professional
For production workloads
- 500,000 requests/month
- 300 requests/min
- 10 API keys
- 90 days analytics
- Webhooks
- Countries data (250+ countries)
- States & provinces (5,000+)
- Cities (150,000+)
- Global search
- Live currency rates (25 base currencies)
- IP geolocation
- Priority support (24h)
- 99.5% SLA
- Up to 5 team members
You'll receive email alerts at 80% and 100% usage. Requests are blocked once your monthly quota is reached — upgrade anytime to continue.
Frequently asked questions
250+ countries (capitals, flags, population, phone codes, and 40+ fields), 5,000+ states/provinces, 150,000+ cities with coordinates, timezones with DST data, live exchange rates for 161+ currencies with 25 selectable base currencies (USD, EUR, GBP, JPY, and more), languages, and IP geolocation.
Something not covered here?
Email us at support@apogeoapi.com
Start building in minutes
Sign up, get an API key, and make your first request. Every account starts with a 14-day Basic trial — 15K requests/month and full access to all endpoints. No credit card required.