API AccessAccess dataset files directly from scripts, code, or AI agents.
Browse dataset files
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 Previews
admin1
Schema
| name | 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 |
Data Files
| File | Description | Size | Last modified | Download |
|---|---|---|---|---|
admin1 | 44.5 MB | 19 days ago | admin1 |
| Files | Size | Format | Created | Updated | License | Source |
|---|---|---|---|---|---|---|
| 1 | 44.5 MB | geojson | 19 days ago | Open Data Commons Public Domain Dedication and License v1.0 | Natural Earth |
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.