Single-page reference
ApogeoAPI Cheatsheet
Every endpoint, one page. Print to PDF for desk reference.
Tip: Ctrl/Cmd + P → save as PDF for a clean desk reference. Or fork the Postman collection for an interactive version.
Base URL
https://api.apogeoapi.com
Auth
X-API-Key: …
Free quota
1,000 req / month
Rate limits
5/min free · 30+/min paid
Countries
/v1/countries
Paginated list of all countries
/v1/countries/{code}
Country by ISO-2 code (with currencyRate)
/v1/countries/search?q=
Search countries by name
/v1/countries/{code}/currency-rate
Live USD rate for country currency
/v1/countries/{code}/timezones
Country timezones with DST
/v1/countries/{code}/translations
Country name in multiple languages
/v1/countries/region/{region}
Africa | Americas | Asia | Europe | Oceania | Antarctic
/v1/countries/subregion/{subregion}
e.g. South America, Western Europe
/v1/countries/phone/{code}
Reverse lookup by phone code (54 → AR)
/v1/countries/currency/{code}
All countries using currency (EUR → 19 results)
States / Provinces
/v1/countries/{code}/states
List states for a country
/v1/countries/{code}/states/search?q=
Search states
/v1/states/{id}
State by ID
/v1/states/types
List of admin division types
/v1/states/type/{type}
States by type (state | province | region | …)
Cities
/v1/states/{id}/cities
List cities in a state
/v1/states/{id}/cities/search?q=
Search cities in a state
/v1/cities/{id}
City by ID with coordinates + population
IP Geolocation
/v1/ip
Geolocate caller's IP
/v1/ip/{address}
Geolocate specific IPv4 / IPv6
Exchange Rates
/v1/exchange-rates/{currency}
Live rate for any currency (USD base)
/v1/exchange-rates/{currency}?base={base}
25 selectable base currencies
Search
/v1/search?q=
Global fuzzy search across countries, states, cities
Account (JWT auth)
/v1/api-keys
List your API keys
/v1/api-keys
Create new API key
/v1/api-keys/{id}/rotate
Rotate (regenerate) a key
/v1/api-keys/{id}
Revoke a key
Billing (public, no auth)
/v1/billing/plans
List pricing tiers and quotas
Quick examples
curl
curl -H "X-API-Key: $KEY" \ https://api.apogeoapi.com/v1/countries/AR
JavaScript (fetch)
const res = await fetch(
'https://api.apogeoapi.com/v1/countries/AR',
{ headers: { 'X-API-Key': process.env.APOGEOAPI_KEY } }
);
const data = await res.json();Python (requests)
import os, requests
r = requests.get(
'https://api.apogeoapi.com/v1/countries/AR',
headers={'X-API-Key': os.environ['APOGEOAPI_KEY']},
)
data = r.json()TypeScript SDK
import { ApogeoAPI } from '@apogeoapi/sdk';
const api = new ApogeoAPI({ apiKey: process.env.APOGEOAPI_KEY! });
const country = await api.getCountry('AR');