GeoIP2 Release Notes

Special release of our geolocation databases

We are issuing an off-schedule release of our geolocation databases in order to update the country-level geolocation for for a number of networks associated with the Starlink satellite ISP and some additional minor data corrections.

Please download the databases released later today to get the most up to date geolocation information.

This impacts the following databases:

• GeoIP Country database

• GeoIP City database

• GeoIP Enterprise database

• GeoLite Country database

• GeoLite City database

GeoIP web service users will receive this update automatically.

More non-ASCII characters in English place names in GeoIP products and services

Beginning this week, you will see more English place names in GeoIP products and services that contain non-ASCII characters, especially for small villages and towns. Non-ASCII characters may contain diacritics, accents and other marks, for example:

You may see English names with non-ASCII characters in all products and services that contain geolocation data, including:

• GeoIP Insights, City Plus, and Country web services
• GeoIP Enterprise, City, and Country databases
• minFraud Insights and Factors web services
• GeoLite City and Country web services
• GeoLite City and Country databases

Cloudflare WARP will be identified as a consumer privacy network

Beginning Friday, October 20, Cloudflare WARP will be identified as a consumer privacy network in our data.

Consumer privacy networks are VPNs managed by tech companies. Access to these networks is tied to a user account that is usually tied to other products and services more closely associated with the consumer's real identity. These networks are not necessarily used for the kinds of malicious activity that VPNs, residential proxies, and other anonymizing networks are used for.

Consumer privacy networks are identified in our user type data with the value consumer_privacy_network, and can be identified by name in our ISP data. This data can be accessed in the following MaxMind products and services:

User Type Data:

• GeoIP Insights web service
• GeoIP Enterprise database

ISP Data:

• GeoIP Insights web service
• GeoIP City Plus web service
• GeoIP ISP database
• GeoIP Enterprise database

Learn more about Cloudflare WARP on Cloudflare's website.

Learn more about consumer privacy networks on our Knowledge Base.

GeoNames Monthly Diff Report October 2023

GeoNames Monthly Diff Report (October 2023)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of October as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the old_ and new_ columns for a given field only differ for the field defined in the diff_in column.

* In this month's update there are changes to a number of geoname IDs for locations in Brazil.

GeoNames Monthly Diff Report September 2023

GeoNames Monthly Diff Report (September 2023)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of September as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the old_ and new_ columns for a given field only differ for the field defined in the diff_in column.

* Please note: Although we do not include information about time_zone in our monthly Diff Reports, GeoNames is updating the time zones for a number of locations in Ukraine. These updates will be reflected in our time_zone data, which is present in all of our IP geolocation databases and web services.

New Satellite connection type releasing

Effective Tuesday August 29, 2023 we will be adding a new connection type value, Satellite, which will identify satellite internet providers such as Starlink, Viasat, and Hughes. Satellite connections typically have higher latency than cable/DSL connections.

The Satellite connection type value will appear in the following databases:

• GeoIP Connection Type database
• GeoIP Enterprise database

Users of the following client APIs will need to update their API to the latest version to avoid breaking changes with the new value:

• Update Java API to version 4.1.0
• Update Node API to version 4.2.0

API policies - temporary enforcement on October 17, 2023

To improve our server infrastructure and allow for better performance and efficiency, MaxMind will begin enforcing our policies around our API and database download requests in March 2024. To help customers get ready for this change, we will have a planned, temporary enforcement of these policies on October 17, 2023.

What are the policies?

• MaxMind will only accept API and database download requests sent with the more secure HTTPS protocol.
• MaxMind will only accept API and database download requests that are sent to the appropriate hostname as documented in the integration instructions on our Developer Portal (see direct links below).

What do I need to do? If you download GeoIP or GeoLite databases and you use an up to date version of our geoipupdate program, you do not need to take any action.

If you are using web services, or if you do direct downloads of GeoIP or GeoLite databases, you should ensure that you are using the correct hostname for your API requests, and that you are using HTTPS, prior to October 17, 2023. You can view the appropriate URIs for GeoIP and GeoLite services and downloads on our Developer Portal using the links below:

• GeoIP Country, City Plus, and Insights web services
• GeoIP and GeoLite database downloads
• GeoIP Legacy web services
• GeoLite web services

Please note: This enforcement will also effect minFraud API requests. If you are also a minFraud user, see our minFraud release note on this issue.

GeoNames Monthly Diff Report August 2023

GeoNames Monthly Diff Report (August 2023)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of August as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the old_ and new_ columns for a given field only differ for the field defined in the diff_in column.

* A number of new features with improved names were added to Brazil in this month's update.

Resolving more networks to borough of Queens, New York

Starting with tomorrow's release we will begin resolving IPs that currently return the neighborhood of Flushing (Queens, NY) to the corresponding borough of Queens in the city name field.

For more granular place identification (such as neighborhood), we recommend using the postal code where provided.

New Satellite connection type

On Tuesday August 29, 2023 we will be adding a new connection type value, Satellite, which will identify satellite internet providers such as Starlink, Viasat, and Hughes. Satellite connections typically have higher latency than cable/DSL connections.

The Satellite connection type value will appear in the following databases:

• GeoIP Connection Type database
• GeoIP Enterprise database

Users of the following client APIs will need to update their API to the latest version to avoid breaking changes with the new value:

• Update Java API to version 4.1.0
• Update Node API to version 4.2.0

GeoNames Monthly Diff Report July 2023

GeoNames Monthly Diff Report (July 2023)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of July as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the old_ and new_ columns for a given field only differ for the field defined in the diff_in column.

* This month's update contains a large number of updated names for cities in Vietnam.

Twice weekly updates for the GeoIP Domain Name database

Beginning this Friday, June 16, we will update the GeoIP Domain Name databases twice weekly on Tuesdays and Fridays (instead of monthly). We made this change so that data corrections and updates can be deployed more quickly.

If you would like to take advantage of these more frequent updates, you will have to update the schedule of your GeoIP database downloads. You can find documentation on updating your GeoIP databases on our developer’s site.

Correction regarding London boroughs in our geolocation data

On June 6, we announced that more networks would be mapped to London boroughs beginning on Friday, June 9.

This change has been delayed. It should be present in our products and services beginning on Friday, June 16.

In addition, for networks in the greater London area we will be returning the name of the town for city-level name data instead of the borough. The borough will be populated in the second level subdivision.

For example, a network that maps to the Walthamstow town will return Walthamstow for the city_name, and Walthamstow Forest for the second level subdivision.

Delayed update for GeoIP Anonymous IP database

We are aware of an issue that caused a delay to the GeoIP Anonymous IP database release. The database was not released on Friday, June 9 through Sunday, June 11.

The issue has been corrected, and the database will be released today, Monday, June 12, and going forward, as normal.

GeoNames Monthly Diff Report June 2023

GeoNames Monthly Diff Report (June 2023)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of June as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the old_ and new_ columns for a given field only differ for the field defined in the diff_in column.

* This month's update contains a large number of updated names for cities in India.

More networks mapped to London boroughs

When a network geolocates to London, we will often return the borough for the city, rather than returning London. Beginning this Friday, June 9, we will be mapping more networks to London boroughs.

This change will apply to all products and services with city-level geolocation data:

• GeoIP City database
• GeoIP City Plus web service
• GeoIP Insights web service
• GeoIP Enterprise database
• minFraud Insights web service
• minFraud Factors web service
• GeoLite City web service
• GeoLite City database

GeoNames Monthly Diff Report May 2023

GeoNames Monthly Diff Report (May 2023)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of May as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the old_ and new_ columns for a given field only differ for the field defined in the diff_in column.

Off-schedule GeoIP Domain database update

We have released an off-schedule update to the GeoIP Domain database to correct a few minor errors.

New update schedule for GeoIP Domain database

We are changing the release schedule for our GeoIP Domain database.

The next update of the GeoIP Domain database will release on Tuesday, May 2, 2023. Going forward, the GeoIP Domain database will be released on the first Tuesday of each month.

Previously, the GeoIP Domain database was updated every fourth Tuesday.

GeoNames Monthly Diff Report April 2023

GeoNames Monthly Diff Report (April 2023)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of April as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the old_ and new_ columns for a given field only differ for the field defined in the diff_in column.

Issue Geolocating IPs in Portugal

We are aware of an issue in which our geolocation products and services are not returning correct city-level data for IP addresses located in Portugal.

The issue was introduced in our release of GeoIP databases last Friday, March 17. The issue has been fixed and will be corrected in the next release of our GeoIP databases, scheduled for Tuesday, March 21.

The following products and services are affected:

• GeoIP City database
• GeoIP Enterprise database
• GeoLite City database
• GeoIP City Plus web service
• GeoIP Insights web service

Web service customers will see the corrected data right away. Database customers should download the latest update to our databases to get access to corrected data.

Changes to MaxMind License Keys

We are making changes to the format of our license keys:

• New license keys will be longer, with a six character prefix.
• Beginning on March 27, 2023, we will no longer be issuing unhashed license keys for use with legacy versions of our GeoIP Update program (any version prior to v3.1.1).

For customers using our REST API, Client APIs or version 3.1.1 and higher of our GeoIP Update program:

No action is required. Existing license keys will still be valid and will continue to function normally.

New license keys will have the following changes:

• The character set is changing from [a-zA-Z0-9] to [a-zA-Z0-9_].
• The length of the license key will now be 40 characters.
• License keys will have a _mmk suffix.

Please note that the length of license keys may be increased in the future.

Customers using legacy versions of our GeoIP Update program:

Legacy versions of geoipupdate use less secure unhashed license keys. Beginning on March 27, 2023 we will no longer be issuing new unhashed license keys. Your existing license keys can continue to be used, but you will no longer be able to generate new unhashed license keys.

New license keys only work with geoipupdate version 3.1.1 or greater. We encourage you to update to the latest version at your earliest convenience.

Learn how to upgrade from geoipupdate legacy to the current version on our Developer’s Portal.

GeoNames Monthly Diff Report March 2023

GeoNames Monthly Diff Report (March 2023)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of March as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

Geolocate Tor Exit Nodes in GeoIP and GeoLite

We have added geolocation data for Tor exit nodes to all our GeoIP and GeoLite products and services with geolocation data.

Please note that the geolocation for Tor exit nodes is not the geolocation of the end user of the IP address, but the geographical location of the exit node itself. Learn more about Tor and other anonymizers on our Knowledge Base.

Geolocation data for Tor exit nodes is now present in:

• GeoIP2 Country database
• GeoIP2 City database
• GeoIP2 Enterprise database
• GeoIP2 Country web service
• GeoIP2 City Plus web service
• GeoIP2 Insights web service
• GeoLite2 Country database
• GeoLite2 City database
• GeoLite2 Country web service
• GeoLite2 City web service

GeoNames Monthly Diff Report February 2023

GeoNames Monthly Diff Report (February 2023)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of February as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

Change to AT&T ISP name

On Monday, February 6 we will be updating MaxMind products and services with ISP data to consolidate naming conventions for certain AT&T ISP names. We will now return AT&T Internet instead of AT&T Internet Services and AT&T U-verse. We are updating these values to more accurately reflect new brand name used by AT&T.

The following databases and services are affected by this change:

• GeoIP2 ISP database
• GeoIP2 Enterprise database
• GeoIP Legacy ISP and Organization databases
• GeoIP2 City Plus and Legacy City Web Service
• GeoIP2 and Legacy Insights Web Service
• minFraud Insights
• minFraud Factors

GeoNames Monthly Diff Report January 2023

GeoNames Monthly Diff Report (January 2023)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of January as they relate to the following fields:

• geoname_id
• country_name
• country_code
• city_name
• subdivision_1_iso_code
• subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

* A number of the cities in Ukraine have been updated with more accurate English names.