Search cities and urban areas (GHS Functional Urban Areas)
Search cities / urban areas from the JRC Global Human Settlement Functional Urban Areas (GHS-FUA) dataset by name, bounding box, and optional ISO 3166-1 alpha-3 country filter. The returned id is suitable for use as city_id on emission queries. Data sourced from Climate TRACE under CC BY 4.0.
Query parameters
City / urban-area name substring.
City / urban-area name substring.
ISO 3166-1 alpha-3 country code restricting the search.
ISO 3166-1 alpha-3 country code restricting the search.
Bounding box filter as minX,minY,maxX,maxY in EPSG:4326.
Bounding box filter as minX,minY,maxX,maxY in EPSG:4326.
Maximum rows per page (1 to 1000).
Maximum rows per page (1 to 1000).
Offset into the result set.
Offset into the result set.
Response
Matched urban-area records with GHS-FUA identifiers and alternate names.
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}