Official collection

Postman Collection — every endpoint, pre-configured

25+ ready-to-fire requests covering countries, states, cities, IP geolocation, exchange rates, search, billing, and key management. Auth is pre-wired with an environment variable — paste your free API key and start firing.

▶ Run in Postman Download collection.json Download environment

Don't have an API key yet? Sign up free — 1,000 requests / month forever, no credit card.

What's inside

Folders organized by resource. Every request has a description, sample parameters, and the right auth header. Hit Send and read JSON.

Countries

→List countries (paginated)
→Get country by ISO code
→Search countries by name
→Get currency rate for country
→Countries by region / subregion / phone code / currency
→Country timezones / translations

States / Provinces

→List states for a country
→Search states in a country
→Get state by ID
→List administrative division types

Cities

→List cities in a state
→Search cities in a state
→Get city by ID

IP Geolocation

→Geolocate caller's IP
→Geolocate specific IP

Search

→Global search (countries + states + cities)

API Keys (account)

→List my API keys
→Create new API key

Billing

→List plans (public, no auth)

Setup in 60 seconds

1
Click "Run in Postman"
Postman opens (web or desktop), prompts you to fork the collection into your workspace. Hit "Fork Collection".
2
Download the environment file
Click "Download environment" above. In Postman, go to Environments → Import → drop the file in. It pre-defines `base_url` and a `apogeoapi_key` placeholder.
3
Paste your free API key
In the imported environment, set `apogeoapi_key` to your real key from app.apogeoapi.com. Save.
4
Pick the environment + send
Top-right of Postman, switch the environment dropdown to "ApogeoAPI — Production". Open any request and hit Send. You should see JSON within ~100ms.

Prefer raw OpenAPI? Download the spec: /openapi.json. Compatible with Insomnia, Bruno, Hoppscotch, and any OpenAPI 3.0 tool.

Get your free API key

1,000 requests / month forever + 14-day full trial of all paid features. No credit card required.