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
Explore with AIgeoip2-ipv4
| Field | Type | Description |
|---|---|---|
| network | string | This is the IPv4 network in CIDR format such as 2.21.92.0/29. |
| geoname_id | integer | A unique identifier for the network's location as specified by GeoNames. |
| continent_code | string | The continent code for this IP. Possible codes are: AF - Africa, AS - Asia, EU - Europe, NA - North America, OC - Oceania, SA - South America |
| continent_name | string | The continent name for this location |
| country_iso_code | string | A two-character ISO 3166-1 country code for the country associated with the location. |
| country_name | string | The country name for this location. |
| is_anonymous_proxy | boolean | A 1 if the network is an anonymous proxy, otherwise 0. |
| is_satellite_provider | boolean | A 1 if the network is for a satellite provider that provides service to multiple countries, otherwise 0. |
Download
Download CSVAbout
- Last updated
- 3 May 2026
- Total rows
- ...
- Format
- CSV
- File size
- 31.9 MB
- Source
- Maxmind GeoLite2
About this dataset
Database of IPv4 address networks with their respective geographical location.
Data
Based on GeoLite2 Country Free Downloadable Databases as of Apr 21, 2015 http://dev.maxmind.com/geoip/geoip2/geolite2/
Two files were used to generate this dataset:
GeoLite2-Country-Blocks-IPv4.csv
GeoLite2-Country-Locations-en.csv
with the following considerations:
- Where geoname_id was not available, registered_country_geoname_id was used.
- Where geoname_id and registered_country_geoname_id where empty, geoname_id, continent_code, continent_name, country_iso_code and country_name are empty.
Preparation
Process is recorded and automated in python script:
# Install the requirements
pip install -r scripts/requirements.txt
# Make sure to add your own Account_ID and License_key password as env variables
username = os.getenv('MAXMIND_USERNAME')
password = os.getenv('MAXMIND_PASSWORD')
# Run the code
python scripts/process.py
Automation
Up-to-date (auto-updates every week) geoip2-ipv4 dataset could be found on the datahub.io: https://datahub.io/core/geoip2-ipv4
License
Datapackage: Creative Commons Zero
Original CSV: This dataset includes GeoLite2 data created by MaxMind, available from www.maxmind.com