Adcode Administrative Region Lookup (Domestic & International)
Free administrative-region API. No registration or API key required. Covers China’s four-level administrative hierarchy (province / city / district / subdistrict — 43,151 records) and 31,251 cities across 243 countries worldwide. Three lookup modes: exact lookup by Adcode (administrative code) returning the children list (e.g. China > Shandong > Jinan > Lixia District > Shunhua Road Subdistrict); reverse-geocoding by latitude/longitude returning the nearest regions; keyword search across cities and districts (Chinese and English). At least one query parameter is required. Returns structured data including administrative level, centroid coordinates, ISO 3166-1 country code, etc. Chinese records include `adcode` and `citycode`; international records additionally include population and time zone. JSON responses suitable for four-level address pickers, e-commerce shipping-address forms, logistics zoning, map applications, LBS services, real-estate city filters, travel destination search, and geospatial analytics. The endpoint auto-detects the query mode from the parameters; default response cache is 6 hours. · Suitable for four-level cascading address pickers, e-commerce shipping-address components, logistics zoning systems, administrative-region visualisation in maps, LBS services and nearby-place queries, city/region filters in real-estate platforms, travel destination search, government administrative-region management, geospatial heatmaps, food-delivery zone planning, last-mile network coverage analysis, and demographic / urban-planning analytics. · Adcode Administrative Region Lookup (Domestic & International)
administrative region API, free administrative division API, adcode lookup API, China administrative code lookup, four-level province/city/district/subdistrict API, administrative-code API, reverse-geocode region, latitude/longitude city API, reverse geocoding API, geocoding API, global city API, international city data API, address picker API, three-level cascading address API, LBS location API, city search API, district lookup API, subdistrict lookup, China administrative region data, administrative division children lookup, free geographic data API, city adcode mapping, no-registration geo API, ISO country code lookup, city coordinates API
GET /misc/district - Adcode Administrative Region Lookup (Domestic & International)
One endpoint covering 243 countries and China’s four-level administrative hierarchy (province / city / district / subdistrict). Three query modes are supported (at least one parameter is required): keyword search, administrative-code lookup, and reverse-geocoding by coordinates.
Overview
The endpoint returns the matching administrative regions for the given inputs. For example: China Shandong Jinan Lixia District Shunhua Road Subdistrict.
No registration or API key required. Three query modes:
- Pass adcode for exact lookup by administrative code; the children list is returned alongside the matched region.
- Pass lat + lng to reverse-geocode and return the nearest regions.
- Pass keywords for keyword search (Chinese and English).
Domestic vs international data
Chinese records include adcode and citycode and support drilling down through province / city / district / subdistrict. International records do not include these fields but additionally provide population and timezone.
[!NOTE]
Some cities (e.g. Dongguan, Wenchang) skip the district level and place subdistricts directly under the city. The subdistrict-level adcode returns the parent district’s adcode.