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
countries
Schema
| name | type | description |
|---|---|---|
| name | string | Common name of the country |
| ISO3166-1-Alpha-3 | string | 3 characters code for the country, according to ISO3166 standard |
Data Files
| File | Description | Size | Last modified | Download |
|---|---|---|---|---|
countries | 14.6 MB | 26 days ago | countries |
| Files | Size | Format | Created | Updated | License | Source |
|---|---|---|---|---|---|---|
| 1 | 14.6 MB | geojson | 11 months ago | Open Data Commons Public Domain Dedication and License v1.0 | Natural Earth |
Description
Geodata data package providing geojson polygons for all the world's countries. Perfect for use in apps and visualizations.
Data
The data comes from Natural Earth, a community effort to make visually pleasing, well-crafted maps with cartography or GIS software at small scale.
More info about countries can be obtained from datapackage https://github.com/datasets/country-codes by a join on field ISO3166-1-Alpha-3
Preparation
To run the script and update the data:
Prerequisites
-
Install required tools:
- GDAL - for geographic data processing
-
Verify GDAL installation:
ogr2ogr --version
Data Processing
The project uses ogr2ogr to convert Natural Earth's country boundaries from Shapefile to GeoJSON format, with the following features:
- Coordinate precision set to 6 decimal places
- Geometry validation enabled (
-makevalid):- Fixes self-intersecting polygons
- Corrects ring orientation
- Removes duplicate vertices
- Ensures geometric validity for better compatibility with GIS tools
- Selected fields:
name: Common name of the country (from admin field)ISO3166-1-Alpha-2: Two-letter ISO country code (from iso_a2 field)ISO3166-1-Alpha-3: Three-letter ISO country code (from iso_a3 field)
To process the data:
make data
This will:
- Download the Natural Earth countries dataset
- Convert it to GeoJSON format with the specified settings
- Save the result in
data/countries.geojson
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. While no credit is formally required a link back or credit to Natural Earth, Lexman and the Open Knowledge Foundation is much appreciated.
All source code is licenced under the MIT licence.