Loading
Loading
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.
Access all standard world regions including Africa, Americas, Asia, Europe, and Oceania as structured data for integration into global applications and geographic filtering systems.
Retrieve all subregions belonging to any specified world region for geographic segmentation, cascading dropdowns, and region-aware filtering.
Navigate the two-level region–subregion hierarchy to build progressive geo-filters and multi-tier geographic classification systems.
Retrieve region and subregion records quickly for real-time applications, international onboarding systems, and live geographic search experiences.
Supports both json and xml response formats for compatibility with modern web applications and enterprise integrations.
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)
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=Asia"
payload = {}
headers = {
'X-apiKey': 'API-KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
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 "https://api.apifreaks.com/v1.0/geo/regions?apiKey=YOUR_API_KEY"
Retrieve a detailed list of subregions based on the region provided. Use the exact region name as returned by the regions endpoint.
# Response { "subregions": [ "Central Asia", "Eastern Asia", "South-Eastern Asia", "Southern Asia", "Western Asia" ] }curl "https://api.apifreaks.com/v1.0/geo/subregions?apiKey=YOUR_API_KEY®ion=Asia"
region=Africa returns all subregions of Africa including Eastern Africa, Northern Africa, Western Africa, and more. Always use the exact region names returned by the regions endpoint to avoid a 400 invalid region name error.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.