Skip to content

Latest commit

 

History

History

ip-geolocation

README.md

IP Geolocation

Every IP range mapped to continent, country, region and city, with the city's coordinates, timezone, postal code and GeoNames ID, an accuracy radius, the date the location last changed, and a US range's DMA code.

Field Value
ID ip_geolocation_v1
Formats csvgz, mmdb
Update frequency Daily
Full database 12,533,715 entries, 150 MB as CSV and 85.9 MB as MMDB, on 2026-11-17
This sample 100 rows from the 2026-11-17 build
License This sample: CC BY-SA 4.0. The full database: licensed per database, request an evaluation
Docs docs.internetdata.io/database/ip-geolocation

Files

Overview

Every IPv4 and IPv6 range mapped to a continent, a country, a region and a city, with the latitude and longitude of the city, its IANA timezone and a postal code: the range's own where it's known, else the city's main one. Every range carries a country, and all but a handful a city: a range placed only to its region or country names that area's most likely city. The few without one are in Bouvet Island (BV) and Heard Island (HM).

Each row also carries:

  • geoname_id: the city's ID in the GeoNames gazetteer.
  • accuracy_radius: the radius in kilometers around the latitude and longitude that holds the true location with 67% confidence. An anycast range, which answers from many places, has 20000.
  • last_changed: the date the range's location (its country, region, city or coordinates) last changed. The earliest date in the file means on or before that day.
  • dma_code: a US city's TV market (DMA, designated market area) as its 3-digit code: 501 is New York, 803 Los Angeles. Empty outside the US.

The continent, the country, the timezone, the currency and the flag of every range, and nothing finer, are free in IP Country.

Fields

CSV (csvgz)

Name Type Description Example
start_ip ipaddress Start IP of the IP range. 1.0.0.0
end_ip ipaddress End IP of the IP range. 1.0.0.255
continent string Continent of the IP range. OC
country string ISO 3166-1 alpha-2 country code. AU
country_name string Country name of the IP range. Australia
region_code string ISO 3166-2 region code, where it has one. AU-QLD
region string Region (state/province) name, if any. Queensland
city string City name, on every row but the few in BV and HM, which have no city: a range placed only to its region or country names that area's most likely city. Brisbane
latitude float Latitude of the city. -27.46794
longitude float Longitude of the city. 153.02809
timezone string IANA timezone of the IP range. Australia/Brisbane
postal_code string The range's own postal code where known, else its city's main postal code. Empty where the country has no postal codes, or none are known for it. 4000
geoname_id string GeoNames ID of the city. 2174003
accuracy_radius integer Radius in km around the latitude and longitude that holds the true location with 67% confidence; 20000 for an anycast range, which answers from many places. 20000
last_changed date Date the range's location (country, region, city or coordinates) last changed. The earliest date in the file means on or before that day. 2026-10-13
dma_code string The city's US TV market (DMA, designated market area) as its 3-digit code: 501 is New York, 803 Los Angeles. Empty outside the US. 602

MMDB (mmdb)

Each record is looked up by IP address and holds:

Name Type Description Example
continent string Continent of the IP range. OC
country string ISO 3166-1 alpha-2 country code. AU
country_name string Country name of the IP range. Australia
region_code string ISO 3166-2 region code, where it has one. AU-QLD
region string Region (state/province) name, if any. Queensland
city string City name, on every row but the few in BV and HM, which have no city: a range placed only to its region or country names that area's most likely city. Brisbane
latitude float Latitude of the city. -27.46794
longitude float Longitude of the city. 153.02809
timezone string IANA timezone of the IP range. Australia/Brisbane
postal_code string The range's own postal code where known, else its city's main postal code. Empty where the country has no postal codes, or none are known for it. 4000
geoname_id string GeoNames ID of the city. 2174003
accuracy_radius integer Radius in km around the latitude and longitude that holds the true location with 67% confidence; 20000 for an anycast range, which answers from many places. 20000
last_changed date Date the range's location (country, region, city or coordinates) last changed. The earliest date in the file means on or before that day. 2026-10-13
dma_code string The city's US TV market (DMA, designated market area) as its 3-digit code: 501 is New York, 803 Los Angeles. Empty outside the US. 602

The full database

The full database needs a license: request an evaluation to test the whole file first. With a licensed API key:

curl -L -o ip_geolocation_v1.csv.gz "https://internetdata.io/api/v2/database/download?id=ip_geolocation_v1&format=csvgz&apikey=$APIKEY"
curl -L -o ip_geolocation_v1.mmdb "https://internetdata.io/api/v2/database/download?id=ip_geolocation_v1&format=mmdb&apikey=$APIKEY"

Today's sample is on its page, cut from the latest build.

Back to all InternetData sample databases.