geoip2 v5.2.0 Release Notes

Release Date: 2025-11-20 // 4 months ago
    • IMPORTANT: Python 3.10 or greater is required. If you are using an older
      ๐Ÿ”– version, please use an earlier release.
    • โฌ†๏ธ maxminddb has been upgraded to 3.0.0. This includes free-threading
      ๐Ÿ‘Œ support.
    • ๐Ÿ— Setuptools has been replaced with the uv build backend for building the
      ๐Ÿ“ฆ package.
    • A new anonymizer object has been added to geoip2.models.Insights.
      This object is a geoip2.records.Anonymizer and contains the following
      fields: confidence, network_last_seen, provider_name,
      is_anonymous, is_anonymous_vpn, is_hosting_provider,
      is_public_proxy, is_residential_proxy, and is_tor_exit_node.
      These provide information about VPN and proxy usage.
    • A new ip_risk_snapshot property has been added to
      geoip2.records.Traits. This is a float ranging from 0.01 to 99 that
      represents the risk associated with the IP address. A higher score indicates
      a higher risk. This field is only available from the Insights end point.
    • ๐Ÿ—„ The following properties on geoip2.records.Traits have been deprecated:
      is_anonymous, is_anonymous_vpn, is_hosting_provider,
      is_public_proxy, is_residential_proxy, and is_tor_exit_node.
      Please use the anonymizer object in the Insights model instead.

Previous changes from v5.1.0

    • ๐Ÿ‘Œ Support for the GeoIP Anonymous Plus database has been added. To do a lookup
      in this database, use the anonymous_plus method on Reader.
    • ๐Ÿ“š Reorganized module documentation to improve language-server support.