GeoIP Residential Proxy Databases

The GeoIP Residential Proxy database is under active development. New fields are expected to be added. Please design your integrations to expect new fields, and ensure you monitor updates to our GeoIP release notes to get notifications about new fields and changes to existing ones.

MaxMind’s GeoIP Residential Proxy database helps protect your business by identifying IP addresses sighted in a residential proxy network. Residential proxy networks use IP addresses commonly assigned to homes, small businesses, and other end users of the internet to provide proxy access via compromised devices. This feed includes confidence scores, timestamps, and residential proxy provider names.

The GeoIP Residential Proxy database is included with a license for the GeoIP Anonymous Plus database. 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 that are open source. We also provide a list of unsupported and unofficial client APIs and unsupported and unofficial integrations with various applications.

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.

Learn about the fields in the binary version of this database on our binary database field reference page.

Looking up an IP

The geoip2 Python client library does not yet ship model classes for this database. Use the lower-level maxminddb reader to read records directly:

import maxminddb

with maxminddb.open_database("GeoIP-Residential-Proxy.mmdb") as reader:
    record = reader.get("1.2.3.4")
    if record is not None:
        print(record["provider_name"])
        print(record["anonymizer_confidence"])
        print(record["network_last_seen"])

CSV Database

In addition to our MaxMind DB binary format, we also offer GeoIP and GeoLite 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 GeoIP-Residential-Proxy-CSV_{YYYYMMDD}.zip. The downloaded zip file contains a single directory which in turn contains several files. That directory is named GeoIP-Residential-Proxy-CSV_{YYYYMMDD}.

The files in this zip archive are:

Filename	Description
`LICENSE.txt`	End user license
`COPYRIGHT.txt`	Copyright statement
`GeoIP-Residential-Proxy-Blocks-IPv4.csv`	CSV file containing data on IPv4 addresses
`GeoIP-Residential-Proxy-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 GeoIP-Residential-Proxy-Blocks-IPv4.csv and GeoIP-Residential-Proxy-Blocks-IPv6.csv respectively.

Data field name	Type	Data field description
network	IP network as a string	This is the IPv4 or IPv6 network in CIDR format such as "2.21.92.0/32" or "2001:4b0::/64". Due to the nature of residential proxies, this database contains mostly IPv4 /32s and IPv6 /64s. We offer a utility to convert this column to start/end IPs or start/end integers. See the conversion utility section for details.
provider_name	string	The name of the residential proxy provider associated with the network. Please note that MaxMind identifies a subset of residential proxy providers. A current list of providers identified in the Residential Proxy database is available on request.
anonymizer_confidence	integer	A score ranging from 1 to 99 that is our percent confidence that the network is currently part of an actively used residential proxy service. These scores are bucketed in 5% buckets, but 1 and 99 are also possible (1, 5, 10, 15, 20, 25, ... 99). Learn more about anonymizer confidence on our Knowledge Base.
network_last_seen	string	The last day that the network was sighted in our analysis of anonymized networks. This is in the ISO 8601 date format (YYYY-MM-DD). Learn more about anonymizer and proxy detection on our Knowledge Base.