Skip to content

Create basic dev docs for little-used premium databases #1483

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Nov 19, 2025
Merged

Create basic dev docs for little-used premium databases #1483

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f3c9978
Add new database dev docs
dhogan8 Nov 10, 2025
6a28aae
Remove and update respective content
dhogan8 Nov 17, 2025
6097779
Update Binary Database section
dhogan8 Nov 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
129 changes: 129 additions & 0 deletions content/geoip/docs/databases/ip-risk.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,129 @@
---
draft: false
title: GeoIP IP Risk Databases
---

Maxmind's GeoIP IP Risk database contains all IP networks associated with
non-corporate proxies, VPNs, and other anonymous IP addresses, and other IP
addresses associated with risky activity.

To learn more about the GeoIP IP Risk database, please see the
[GeoIP IP Risk database overview](https://get.maxmind.com/hubfs/Marketing/GeoIP%20IP%20Risk%20database/GeoIP%20IP%20Risk%20database%20product%20overview.pdf).
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.

{{< snippet "snippets/data-privacy-warning.md" >}}

## Binary Database

{{< snippet "snippets/binary-databases.md" >}}
Copy link
Contributor

@mm-kevcenteno mm-kevcenteno Nov 17, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Our client APIs do not support IP Risk, Static IP score, or User Count databases. The underlying readers should work with them, but how to use them could be an article in themselves.

mmdbinspect does work for these DBs, but that's more of a tool than an integration library. It's still worth mentioning in these docs.

Copy link
Contributor Author

@dhogan8 dhogan8 Nov 17, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@AndraMeer We need to update this section. Currently the snippet says:

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.

But this isn't accurate so we need to use something like the following, but would like your input on specifically what we should say.

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.

Copy link
Contributor

@AndraMeer AndraMeer Nov 19, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So if I'm understanding correctly, we don't want to mention the client APIs for the IP Risk, Static IP score, or User Count databases. Does this work as the copy then? I kept the first sentence of the initial paragraph as it seemed helpful and then removed "also" from "you can also use" in the second.

Binary databases make use of the MaxMind DB file format.
You can 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.


## CSV Database

{{< snippet "snippets/csv-databases-intro.md" >}}

{{< zip-file-content product-name="GeoIP2-IP-Risk" >}}

{{< snippet "snippets/file-format.md" >}}

### Blocks Files

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

{{< rawhtml >}}

<div class="table">
<table>
<tbody>
<tr>
<th>Name</th>
<th>Type</th>
<th>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.125.160.216/29" or "2001:c50::/32". 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.
<br />
<a
href="https://support.maxmind.com/hc/en-us/articles/4408200231067-IP-Network-Data#h_01FN989KWHZG902R63XSJ786RK"
>
Learn more about the network column on our Knowledge Base.
</a>
</td>
</tr>

<tr>
<td>ip_risk</td>
<td>decimal</td>
<td>
This field contains the risk associated with the IP address. The value
ranges from 0.01 to 99. A higher score indicates a higher risk.
<br />
<a
href="https://support.maxmind.com/hc/en-us/articles/4408200231067-IP-Network-Data#h_01FRRHZZP6TB1P6C99JFT16HCR"
>
Learn more about the IP risk score on our Knowledge Base.
</a>
<br />
min: 0.01, max: 99
</td>
</tr>
</tbody>

</table>
</div>
{{</ rawhtml >}}

### Conversion Utility

{{< snippet "snippets/conversion-utility.md" >}}

## Example Files

{{< snippet "snippets/example-files.md" >}}

### CSV Example Files

{{< csv-example-files >}}

- [GeoIP2-IP-Risk-CSV_Example.zip](/static/GeoIP2-IP-Risk-CSV_Example.zip)
{{</ csv-example-files >}}

### MMDB Example Files

{{< mmdb-example-files >}}

- [GeoIP2-IP-Risk-Test.mmdb](https://github.com/maxmind/MaxMind-DB/blob/main/test-data/GeoIP2-IP-Risk-Test.mmdb)
{{</ mmdb-example-files >}}

<!-- ## Database Sizes -->

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

<!-- {{< db-sizes-table dateRange="August to October 2024" >}}
- databaseName: "GeoIP IP Risk"
csvSizeRange: "TBD"
mmdbSizeRange: "TBD"
ipv4Range: "TBD"
ipv6Range: "TBD"
{{< /db-sizes-table >}} -->

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

## Database Changes

{{< database-changes product="IP Risk" >}}

## APIs and Third-Party Integrations

{{< snippet "snippets/geoip-db-apis.md" >}}
133 changes: 133 additions & 0 deletions content/geoip/docs/databases/static-ip-score.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
---
draft: false
title: GeoIP Static IP Score Databases
---

This database indicates how static or dynamic an IP address is, which can be
useful for deciding whether an IP address represents the same user over time.

To learn more about the GeoIP Static IP Score database, including terms and
pricing, please
[contact our Enterprise Business team](https://www.maxmind.com/en/solutions/connect-with-a-geoip-expert)
for assistance.

{{< snippet "snippets/data-privacy-warning.md" >}}

## Binary Database

{{< snippet "snippets/binary-databases.md" >}}

## CSV Database

{{< snippet "snippets/csv-databases-intro.md" >}}

{{< zip-file-content product-name="GeoIP2-Static-IP-Score" >}}

{{< snippet "snippets/file-format.md" >}}

### Blocks Files

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

{{< rawhtml >}}

<div class="table">
<table>
<tbody>
<tr>
<th>Name</th>
<th>Type</th>
<th>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.125.160.216/29" or "2001:c50::/32". 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.
<br />
<a
href="https://support.maxmind.com/hc/en-us/articles/4408200231067-IP-Network-Data#h_01FN989KWHZG902R63XSJ786RK"
>
Learn more about the network column on our Knowledge Base.
</a>
</td>
</tr>

<tr>
<td>static_ip_score</td>
<td>decimal</td>
<td>
An indicator of how static or dynamic an IP address is. The value
ranges from 0 to 99.99 with higher values meaning a greater static
association. For example, many IP addresses with a user_type of
cellular have a score under one. Broadband IPs that don't change very
often typically have a score above thirty.
<br />
This indicator can be useful for deciding whether an IP address
represents the same user over time.
<br />
<a
href="https://support.maxmind.com/hc/en-us/articles/4408200231067-IP-Network-Data#h_01FRRHZZP6XQC228W34VCJV88P"
>
Learn more about the static IP score on our Knowledge Base.
</a>
<br />
min: 0, max: 99.99
</td>
</tr>
</tbody>

</table>
</div>
{{</ rawhtml >}}

### Conversion Utility

{{< snippet "snippets/conversion-utility.md" >}}

## Example Files

{{< snippet "snippets/example-files.md" >}}

### CSV Example Files

{{< csv-example-files >}}

- [GeoIP2-Static-IP-Score-CSV_Example.zip](/static/GeoIP2-Static-IP-Score-CSV_Example.zip)
{{</ csv-example-files >}}

### MMDB Example Files

{{< mmdb-example-files >}}

- [GeoIP2-Static-IP-Score-Test.mmdb](https://github.com/maxmind/MaxMind-DB/blob/main/test-data/GeoIP2-Static-IP-Score-Test.mmdb)
{{</ mmdb-example-files >}}

<!-- ## Database Sizes -->

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

<!-- {{< db-sizes-table dateRange="August to October 2024" >}}
- databaseName: "GeoIP Static IP Score"
csvSizeRange: "TBD"
mmdbSizeRange: "TBD"
ipv4Range: "TBD"
ipv6Range: "TBD"
{{< /db-sizes-table >}} -->

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

## Database Changes

{{< database-changes product="Static IP Score" >}}

## APIs and Third-Party Integrations

{{< snippet "snippets/geoip-db-apis.md" >}}
Loading