API Access
Access dataset files directly from scripts, code, or AI agents.
Browse dataset files
API Access
Access dataset files directly from scripts, code, or AI agents.
Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.
Start with these files — they give you everything you need to understand and access the dataset.
- 1. Fetch datapackage.json to inspect schema and resources
- 2. Download data resources listed in datapackage.json
- 3. Read README.md for full context
Data Files
admin1
| Field | Type | Description |
|---|---|---|
| name | string | Common name of the administrative subdivision |
| admin | string | Country name |
| iso_3166_2 | string | ISO 3166-2 subdivision code |
| adm0_a3 | string | ISO 3166-1 alpha-3 country code |
Download
Download GEOJSONAbout
- Last updated
- 7 March 2026
- Format
- GEOJSON
- File size
- 44.5 MB
- Source
- Natural Earth
About this dataset
Geodata data package providing GeoJSON polygons for first-order administrative subdivisions worldwide.
Data
The data comes from Natural Earth, a public domain map dataset for cartography and GIS.
Admin1 is the biggest administrative subdivision of countries. Note that it is very heterogeneous among countries: in the United States of America, admin1 represents states, whereas they don't represent inner countries in the United Kingdom. For more information, please see official documentation or https://en.wikipedia.org/wiki/Table_of_administrative_divisions_by_country.
The admin1 resource exposes the following key properties:
- name: common name for the subdivision.
- admin: country name.
- iso_3166_2: ISO 3166-2 subdivision code where available.
- adm0_a3: ISO 3166-1 alpha-3 country code.
Preparation
To run the script:
# Install libraries
pip install -r scripts/requirements.txt
# Update the data
python scripts/process.py
License
All data is licensed under the Open Data Commons Public Domain Dedication and License.
Note that the original data from Natural Earth is public domain.
All source code is licenced under the MIT licence.