Returns a list of all available geographic units (countries, regions, etc.) with their ISO 3-letter codes, names, and types. Use this to discover valid geoUnit values for data queries.
From spec: Returns a list of all available geographic units (countries, regions, etc.) with their IDs, names, and types.
Usage Tips
- No authentication required
- Use these ISO 3-letter codes (e.g., USA, FRA, DEU) in the /data/indicators endpoint
- Type field indicates NATIONAL, REGIONAL, etc.
Parameters (1)
geoUnitType(string, query, optional)
Filter by geographic unit type (e.g., NATIONAL, REGIONAL)
Constraints: {'enum': ['NATIONAL', 'REGIONAL']}
Examples (1)
List all geographic units (countries and regions)probe-gate
Demonstrates retrieving all available geographic units with their ISO codes
import requests
resp = requests.get("https://api.uis.unesco.org/api/public/definitions/geounits")
data = resp.json()
import zingu_apis
api = zingu_apis.api("unesco-institute-for-statistics")
result = api.fetch("api/public/definitions/geounits")
for item in result:
print(item)
const resp = await fetch("https://api.uis.unesco.org/api/public/definitions/geounits");
const data = await resp.json();