Global Country Information
Essential demographic, geographic, and economic data for every country in the world.
A comprehensive dataset containing key information for over 250 countries and territories. Indispensable for startups building international apps, logistics software, or AI agents requiring global context.
Source: Restcountries · ISC License · Data provided by Restcountries
Endpoints
Every request is authenticated with your X-API-Key and counted against your plan.
- GET /v1/data/global-country-information
- GET /v1/data/global-country-information/search?q=...
- GET /v1/data/global-country-information/{key}
Base path /v1/data/global-country-information · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.
Fields
| Field | Type | Description |
|---|---|---|
| cca2 | str | ISO 3166-1 alpha-2 country code. |
| name_common | str | Commonly used name of the country. |
| name_official | str | Official name of the country. |
| region | str | Geographical region (e.g., Africa, Americas). |
| subregion | str | Geographical subregion (e.g., Western Europe). |
| population | int | Estimated population of the country. |
| latitude | float | The latitude of the country's approximate geographic center. |
| longitude | float | The longitude of the country's approximate geographic center. |
| area_sqkm | float | Total area in square kilometers. |
What you get
FAQ
- Is this data kept up to date?
- Yes, it is sourced from the active Restcountries project which is regularly maintained.
- Can I look up a country by its name?
- Yes, the API supports search by common name via the /search endpoint.
Pricing
Simple, transparent pricing
Start free, upgrade when you need more. All plans include full API access.
Free
Get started and explore the API
- 100 API requests per day
- All endpoints included
- Community support
Pro
For production apps and AI agents
- 10,000 API requests per day
- All endpoints included
- Priority support
- Usage dashboard
Enterprise
Unlimited access for high-volume use
- Unlimited API requests
- All endpoints included
- Priority support
- Usage dashboard
- Dedicated support channel
Getting Started
Start building in minutes
Register for a free API key, make your first request, and upgrade when you're ready.
Register
Create an account to get your API key. It's free — no credit card required.
curl -X POST https://api.aristocles.com.au/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com", "name": "Your Name"}'Make a request
Use your API key in the X-API-Key header to authenticate requests.
curl https://api.aristocles.com.au/v1/data/asx \
-H "X-API-Key: your_api_key_here"Upgrade
Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.
curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
-H "X-API-Key: your_api_key_here"Check usage
Monitor your daily request count and remaining quota at any time.
curl https://api.aristocles.com.au/v1/usage \
-H "X-API-Key: your_api_key_here"