Regions API - Retrieve World Regions & Subregions
Use our Regions API to retrieve world regions, subregions and geographic area classifications. The API delivers clean, structured world region and subregion data, so you can focus on building instead of managing geographic lookup tables, hardcoded lists, or inconsistent data sources.
Use the Regions API for segmenting users by region, building location selectors, powering a geo-filtering system, or driving international analytics. It gives you the geographic foundation your application needs to scale globally, without the complexity that comes with it.
Features
Complete World Region Dataset
Access all standard world regions including Africa, Americas, Asia, Europe, and Oceania as structured data for integration into global applications and geographic filtering systems.
Subregion Lookup by Region
Retrieve all subregions belonging to any specified world region for geographic segmentation, cascading dropdowns, and region-aware filtering.
Geographic Hierarchy Support
Navigate the two-level region-subregion hierarchy to build progressive geo-filters and multi-tier geographic classification systems.
Fast Regions Lookup
Retrieve region and subregion records quickly for real-time applications, international onboarding systems, and live geographic search experiences.
Multiple Response Formats
Supports both json and xml response formats for compatibility with modern web applications and enterprise integrations.
API Endpoints
Regions API
Retrieve a complete list of all world regions. No filter parameters are required.
$ pip install requestsimport requests
url = "https://api.apifreaks.com/v1.0/geo/regions"
payload = {}
headers = {
'X-apiKey': 'API-KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
Subregions API
Retrieve all subregions within a specified world region. Pass the region parameter with an exact region name returned by the regions endpoint.
$ pip install requestsimport requests
url = "https://api.apifreaks.com/v1.0/geo/subregions?region=Europe"
payload = {}
headers = {
'X-apiKey': 'API-KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
How-to Guides
Complete World Regions List
Retrieve a complete list of regions in the world with the help of the World Regions API.
# Response { "regions": [ "Africa", "Americas", "Asia", "Europe", "Oceania", "Polar" ] }curl -X 'GET' 'https://api.apifreaks.com/v1.0/geo/regions?apiKey=API-KEY'
Find Subregions by Region
Retrieve a detailed list of subregions based on the region provided. Use the exact region name as returned by the regions endpoint.
# Response { "subregions": [ "Eastern Europe", "Northern Europe", "Southern Europe", "Western Europe" ] }curl -X 'GET' 'https://api.apifreaks.com/v1.0/geo/subregions?region=Europe&apiKey=API-KEY'
Frequently Asked Questions
Pricing
To use the Regions API, you will need API credits. We only charge for successful queries, defined by a 2xx status code. If your request results in a 4xx or 5xx status code, no credits will be charged, and any deducted credits will be returned.
For each successful request, 1 credit will be charged.
Utilize the Credits Usage API to efficiently monitor your recent consumption of both one-off and subscription credits. This API provides a streamlined way to track and manage your credit usage, ensuring you stay informed about your remaining balance and can optimize your resource allocation effectively.