GeoIP Direct Downloads

Direct Downloads

This is only recommended for systems unable to use GeoIP Update or for clients using the CSV-format databases.

In order to download the databases from a script or program, please use the permalinks found on the GeoIP download page.

  1. In the “Download Links” column, click “Get Permalink(s)” for the desired database.
  2. Copy the permalink(s) provided in the modal window.
  3. Replace YOUR_LICENSE_KEY with your license key.
  4. If you are using wget or curl from a shell script, please be sure to quote the URL.

This download will return a compressed file in gzip (for binary) or zip (for CSV) format, which can be uncompressed using a program like 7-Zip or gzip.

Checking for the Latest Release Date

You can check the date of a given database’s latest release by issuing a HEAD request for that database’s download permalink URL, as found on our database download page [login required].

For example, using the permalink for the GeoIP2 City CSV database, you can issue a command like the following:

$ curl -I 'https://download.maxmind.com/app/geoip_download?edition_id=GeoIP2-City-CSV&license_key=YOUR_LICENSE_KEY&suffix=zip'

where YOUR_LICENSE_KEY is a placeholder for your account’s actual license key.

In the response, you can check the last-modified header for the file’s build date, or you can check the content-disposition header for the date that would appear in the file name. These checks can be incorporated into your own script or program, according to your needs.

This method only issues a HEAD request, rather than a download request, so running this check won’t count against your daily database download limit.