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
countries
| Field | Type | Description |
|---|---|---|
| name | string | Common name of the country or territory |
| ISO3166-1-Alpha-2 | string | 2-letter ISO 3166-1 country code. Set to "-99" for features that have no assigned ISO code (e.g. disputed or unrecognised territories). |
| ISO3166-1-Alpha-3 | string | 3-letter ISO 3166-1 country code. Set to "-99" for features that have no assigned ISO code (e.g. disputed or unrecognised territories). |
Download
Download GEOJSONAbout
- GeoJSON FeatureCollection of 258 country (and territory) polygons. Features without an assigned ISO code carry the sentinel value "-99" for both ISO fields.
- Last updated
- 9 February 2026
- Format
- GEOJSON
- File size
- 14.6 MB
- Source
- Natural Earth
About this dataset
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.