> **⚠️ Warning**
> 
 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](/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](/geoip/docs/databases/anonymous-plus). If you
are interested in purchasing the database, please
[contact our Enterprise Business team](https://www.maxmind.com/en/solutions/connect-with-a-geoip-expert)
for assistance.

## Binary Database

Binary databases make use of the
[MaxMind DB file format](https://maxmind.github.io/MaxMind-DB/). MaxMind
provides [official client APIs](/geoip/docs/databases/#official-client-apis)
that are open source. We also provide a list of
[unsupported and unofficial client APIs](/geoip/docs/databases/#unofficial-client-apis)
and
[unsupported and unofficial integrations](/geoip/docs/databases/#integrations)
with various applications.

You can also use the [mmdbinspect tool](https://github.com/maxmind/mmdbinspect)
(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.](binary/)

### Looking up an IP

The `geoip2` Python client library does not yet ship model classes for this
database. Use the lower-level
[`maxminddb`](https://github.com/maxmind/MaxMind-DB-Reader-python) reader to
read records directly:

```python
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](<https://en.wikipedia.org/wiki/Zip_(file_format)>).




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.



<div class="table">
  <table>
    <tbody>
      <tr>
        <th>Data field name</th>
        <th>Type</th>
        <th>Data field description</th>
      </tr>

      <tr>
        <td>network</td>
        <td>IP network as a string</td>
        <td>
          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
          <a href="#conversion-utility">the conversion utility section</a> for
          details.
        </td>
      </tr>

      <tr>
        <td>provider_name</td>
        <td>string</td>
        <td>
          <p>
            The name of the residential proxy provider (e.g.,
            <code>oxylabs</code>, <code>smartproxy</code>) associated with the
            network.
          </p>
          <p>
            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.
          </p>
          <p>
            <a
              href="https://support.maxmind.com/knowledge-base/articles/anonymizer-and-proxy-data-maxmind"
              >Learn more about residential proxy provider detection on our
              Knowledge Base.</a
            >
          </p>
        </td>
      </tr>

      <tr>
        <td>anonymizer_confidence</td>
        <td>integer</td>
        <td>
          <p>
            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).
          </p>
          <p>
            <a
              href="https://support.maxmind.com/knowledge-base/articles/anonymizer-and-proxy-data-maxmind"
              >Learn more about anonymizer confidence on our Knowledge Base.</a
            >
          </p>
        </td>
      </tr>

      <tr>
        <td>network_last_seen</td>
        <td>string</td>
        <td>
          <p>
            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).
          </p>
          <p>
            <a
              href="https://support.maxmind.com/knowledge-base/articles/anonymizer-and-proxy-data-maxmind"
              >Learn more about anonymizer and proxy detection on our Knowledge
              Base.</a
            >
          </p>
        </td>
      </tr>
    </tbody>
  </table>
</div>


### Conversion Utility

We've created a
[small utility program](https://github.com/maxmind/geoip2-csv-converter) to
allow you to convert a GeoIP CSV file's representation of IP addresses to
another format. You can choose between start/end IP addresses, with the
addresses represented as strings or integers.

The program is available from our
[geoip2-csv-converter GitHub project releases tab.](https://github.com/maxmind/geoip2-csv-converter/releases)


## Example Files

We maintain example files in CSV and MMDB format. The files contain dummy data
rather than real GeoIP data.


### CSV Example Files

We maintain examples of the CSV files as they would be downloaded from the account portal:



- [GeoIP-Residential-Proxy-CSV_Example.zip](/examples/GeoIP-Residential-Proxy-CSV_Example.zip)
  

### MMDB Example Files

We maintain test MMDB files on GitHub:



- [GeoIP-Residential-Proxy-Test.mmdb](https://github.com/maxmind/MaxMind-DB/blob/main/test-data/GeoIP-Residential-Proxy-Test.mmdb)
  

Alternatively, you can [view all of our MMDB test data on GitHub](https://github.com/maxmind/MaxMind-DB/tree/main/test-data).

## Database Sizes

<!-- prettier-ignore-start -->

MaxMind databases can vary in size from release to release. If you are
working with file size limitations that are concerning, you should build
your integrations to fail gracefully in event of a significant size
change.

From May to August 2026, the database files varied in file size and number of networks as
follows:

| Database | CSV File Size | MMDB File Size | IPv4 Networks | IPv6 Networks |
|----------|---------------|----------------|---------------|---------------|
- databaseName: "GeoIP Residential Proxy"
  csvSizeRange: "3.71 GB - 3.91 GB"
  mmdbSizeRange: "3.15 GB - 3.41 GB"
  ipv4Range: "61,942,000 - 67,626,000"
  ipv6Range: "24,877,000 - 29,297,000"

The listed file sizes are for unpacked databases. Databases are
downloaded in a compressed format.


<!-- prettier-ignore-end -->

## Database Changes

We may add new data fields to the Residential Proxy database at any time.

New database fields are added as new columns to the right of existing columns in our CSV files,
and as additional data in our MMDB files.

Subscribe to our [GeoIP release notes](/geoip/release-notes) to be notified when new
data is added to our databases.

## APIs and Third-Party Integrations

You can find a complete list of official and unofficial client APIs, and
third-party integrations on the
[database documentation page](/geoip/docs/databases#client-apis).


## [GeoIP Residential Proxy binary database fields](/geoip/docs/databases/residential-proxy/binary/)
<p>The GeoIP Residential Proxy binary database contains the following fields for each
network.</p>


<div class="table">
  <table>
    <tbody>
      <tr>
        <th>Data field name</th>
        <th>Type</th>
        <th>Data field description</th>
      </tr>

      <tr>
        <td>anonymizer_confidence</td>
        <td>uint16</td>
        <td>
          <p>
            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).
          </p>
          <p>
            <a
              href="https://support.maxmind.com/knowledge-base/articles/anonymizer-and-proxy-data-maxmind"
              >Learn more about anonymizer confidence on our Knowledge Base.</a
            >
          </p>