Documentation

ApogeoAPI is a single REST API for IP geolocation, country reference data, live exchange rates and cities. Pick your language below and you'll have a working call in under 60 seconds.

Quickstart by language

cURL
IP geolocation, country data, live exchange rates and cities.
JavaScript (fetch)
IP geolocation, country data and live exchange rates.
Node.js (axios)
typed defaults, interceptors and built-in retry. Works in any Node 16+ project.
Python (requests)
drop-in IP geolocation, country data and live exchange rates.
PHP (Guzzle)
Integrate ApogeoAPI into your PHP/Laravel/WordPress project with Guzzle or the built-in cURL extension.
Go (net/http)
no dependencies required.
Ruby (Faraday)
clean, configurable HTTP client.
Java (HttpClient)
no external dependencies needed.
C# (HttpClient)
Use ApogeoAPI from .NET / ASP.NET Core with HttpClient. Works in .NET 6+, Blazor and MAUI.

API surface

IP Geolocation

/v1/ip/:ip

Detect country, city, timezone and ISP from any IPv4/IPv6 address.

Countries

/v1/countries

250 countries with ISO codes, flags, currencies, phone codes, timezones and live FX rates.

Exchange rates

/v1/exchange-rates/:base

161 currencies, refreshed every 4 hours. Real ECB + alternative source coverage including ARS, BRL, NGN.

States & cities

/v1/countries/:code/states

5,000+ states/provinces and 150,000+ cities with coordinates and ISO 3166-2 codes.

Authentication

All requests require an X-API-Key header. Create your free key in the dashboard — 1,000 requests/month on the free tier plus a 14-day full-access trial.

# Base URL
https://api.apogeoapi.com/v1

# Header
X-API-Key: YOUR_KEY

# Example
curl -H "X-API-Key: YOUR_KEY" https://api.apogeoapi.com/v1/countries/AR

Rate limits per tier

  • Free: 5 req/min · 1,000/mo
  • Basic ($19): 30 req/min · 15,000/mo
  • Starter ($29): 60 req/min · 100,000/mo
  • Professional ($79): 300 req/min · 500,000/mo

Headers X-RateLimit-Remaining and Retry-After on 429 responses.

Status codes

  • 200 success
  • 401 invalid or missing API key
  • 404 resource not found (e.g. unknown ISO code)
  • 429 rate limit — see Retry-After header
  • 5xx upstream error — retry with backoff

Try it free in 60 seconds

No credit card. 14-day full access. 1,000 free requests forever.

Get your API key
Looking for the full OpenAPI spec? Open the Swagger UI →