GeoIP2 Anonymous IP Databases

MaxMind's GeoIP2 Anonymous IP CSV database helps protect your business by identifying proxy, VPN, hosting, and other anonymous IP addresses.

To learn more about the GeoIP2 Anonymous IP database, please visit the GeoIP2 Anonymous IP Database page. If you are interested in purchasing the database, please contact our Enterprise Business team for assistance.

Binary Database

Binary databases make use of the MaxMind DB file format. MaxMind provides official client APIs in the language listed below. The following client APIs are open source and licensed under the Apache License, Version 2.0.

You can also use the mmdbinspect tool (in beta), a command line interface built with Go, to look up one or more IPs from one or more MMDB databases and receive output in a parsable JSON format.

Language or Framework	Documentation	Example
.NET (C#)	GitHub - Database Usage	Anonymous IP Example
Java	GitHub - Database Usage	Anonymous IP Example
Node.js	GitHub - Database Usage	Anonymous IP Example
PHP	GitHub - Database Reader	Anonymous IP Example
Python	GitHub - Database Usage	Anonymous IP Example
Ruby	GitHub - Database Reader	Anonymous IP Example

CSV Database

In addition to our MaxMind DB binary format, we also offer GeoIP2 and GeoLite2 databases in a CSV format suitable for importing into a SQL database. The CSV files are shipped as a single zip file.

The zip file itself is named GeoIP2-Anonymous-IP-CSV_{YYYYMMDD}.zip. The downloaded zip file contains a single directory which in turn contains several files. That directory is named GeoIP2-Anonymous-IP-CSV_{YYYYMMDD}.

The files in this zip archive are:

Filename	Description
`LICENSE.txt`	End user license
`COPYRIGHT.txt`	Copyright statement
`GeoIP2-Anonymous-IP-Blocks-IPv4.csv`	CSV file containing data on IPv4 addresses
`GeoIP2-Anonymous-IP-Blocks-IPv6.csv`	CSV file containing data on IPv6 addresses

All the CSV files start with a single header row containing column names. The specific column names and their contents are detailed below. The files are encoded as UTF-8.

Blocks Files

There are two CSV files for network blocks, one each for IPv4 and IPv6 blocks. These are named GeoIP2-Anonymous-IP-Blocks-IPv4.csv and GeoIP2-Anonymous-IP-Blocks-IPv6.csv respectively.

Name	Type	Description
network	IP network as a string	This is the IPv4 or IPv6 network in CIDR format such as “2.21.92.0/29” or “2001:4b0::/80”. We offer a utility to convert this column to start/end IPs or start/end integers. See the conversion utility section for details.
is_anonymous	boolean	1 if the IP address belongs to any sort of anonymous network. Blank if not. * Learn more about anonymizer and proxy detection on our Knowledge Base.
is_anonymous_vpn	boolean	1 if the IP address is registered to an anonymous VPN provider. Blank if not. If a VPN provider does not register subnets under names associated with them, we will likely only flag their IP ranges using the `is_hosting_provider` flag. * Learn more about VPNs on our Knowledge Base.
is_hosting_provider	boolean	1 if the IP address belongs to a hosting or VPN provider (see description of `is_anonymous_vpn` flag). Blank if not. * Learn more about hosting providers used for anonymizing on our Knowledge Base.
is_public_proxy	boolean	1 if the IP address belongs to a public proxy. Blank if not. * Learn more about public proxies on our Knowledge Base.
is_tor_exit_node	boolean	1 if the IP address is a Tor exit node. Blank if not. * Learn more about Tor exit nodes on our Knowledge Base.
is_residential_proxy	boolean	1 if the IP address is on a suspected anonymizing network and belongs to a residential ISP. Blank if not. * Learn more about residential proxies on our Knowledge Base.