Intro
Geo Data is the invisible infrastructure of the modern web. From auto filling forms to formatting prices correctly, understanding the context of your user's location is crucial for a polished User Experience (UX). However, maintaining this database yourself is a nightmare of changing standards and edge cases. We provide APIs to obtain data that belongs to each country, ensuring your application speaks the local language literally and figuratively.
What's in the Box?
Stop hard-coding switch statements and maintaining massive JSON files. Our API provides a comprehensive suite of attributes for every country, including:
- Localization: Country names in various languages, languages spoken, and flag emojis (🇺🇸, 🇩🇪, 🇯🇵).
- Standards & Codes: ISO codes (2 & 3 letter), TLDs (e.g.,
.de), and Calling codes. - Logistics & formatting: Driving side, Zip code patterns, Phone number patterns, and Speed/Distance units.
- Economy & Geography: Currency symbols, Capital cities, Population, Region, Continent, and Country area (km² and mi²).
Why Developers Choose Our API
1. Structured & Predictable
Inconsistent data leads to broken UIs. Our data is normalized and strictly typed. You never have to guess if a field will be null or a string.
Type Safety: Our responses are designed to map directly to interfaces, making it easy to generate TypeScript types or SDKs.
2. Granularity: Fetch Only What You Need
Performance matters. Sometimes you need the whole profile of a country, but sometimes you just need to know if they drive on the left or the right.
We allow you to request specific data points separately to reduce payload size, or fetch the full object for deep context.
3. Usage Examples
Scenario A: The E-Commerce Checkout
You need to validate a phone number and display the correct currency.
{
"countryCode": "JP",
"currencyCode": "JPY",
"currencySymbol": "¥",
"callingCodes": ["81"],
"postalCodeRegex": "^\\d{3}-\\d{4}$"
}
Scenario B: Travel Application
You need to tell the user what side of the road to drive on and the distance units used.
{
"countryCode": "GB",
"name": "United Kingdom",
"drivingSide": "left",
"roadSpeedUnit": "mph",
"roadDistanceUnit": "mi"
}