Part of a Data Solution
- Explore →
Global Country & Region Reference Data Solution
Authoritative country codes, regions and location reference data to power your location-based solutions.
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
- 26 July 2026
- Total rows
- ...
- Format
- CSV
- File size
- 30.3 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