GeoIP2 ISP Databases

Determine the Internet Service Provider, organization name, and autonomous system organization and number associated with an IP address.

To learn more about the GeoIP2 ISP database, including terms and pricing, please visit the GeoIP2 ISP Database page.

Data Privacy

To comply with data privacy regulations, please monitor our Do Not Sell My Personal Information Requests page (login required) for IP addresses and networks that should not be used for advertising or marketing purposes. You can automate retrieval of this list using our privacy exclusions API.

Binary Database

Binary databases make use of the MaxMind DB file format. MaxMind provides official API clients in the language listed below. The following API clients 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.

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-ISP-CSV_{YYYYMMDD}.zip. The downloaded zip file contains a single directory which in turn contains several files. That directory is named  GeoIP2-ISP-CSV_{YYYYMMDD}.

The files in this zip archive are:

FilenameDescription
LICENSE.txtEnd user license
COPYRIGHT.txtCopyright statement
GeoIP2-ISP-Blocks-IPv4.csvCSV file containing data on IPv4 addresses
GeoIP2-ISP-Blocks-IPv6.csvCSV 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-ISP-Blocks-IPv4.csv and GeoIP2-ISP-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.

isp

string

The name of the ISP associated with the IP address.

organization

string

The name of the organization associated with the IP address.

autonomous_system_number

string

The autonomous system number associated with the IP address.

autonomous_system_organization

string

The organization associated with the registered autonomous system number for the IP address.

Conversion Utility

We've created a small utility program to allow you to convert a GeoIP2 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.

This page was last updated on June 17, 2021.