Skip to content

About

Free IP geolocation database with VPN flags, provider-named VPN list, and ip_type infrastructure classification (CC BY-SA 4.0). Updated weekly.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Latest commit

 

History

29 Commits

Folders and files

Repository files navigation

ipgeo Community Edition

A free, no-signup IP geolocation database (MMDB + CSV). It bundles city geolocation with the VPN provider's name behind an IP — across the whole address space rather than only open-proxy ranges — plus a datacenter flag and an infrastructure ip_type classification.

GeoLite2 DB-IP Lite IP2Location LITE X4BNet lists_vpn ipgeo Community
City + ASN geolocation ✔ ✔ ✔ ✘ ✔
VPN flags ✘ (paid) ✘ ✘ ¹ ✔ ✔
VPN provider names ✘ ✘ ✔ ¹ ✘ ✔ (where known)
Infrastructure ip_type ✘ ✘ ✘ ✘ ✔
No account required ✘ ✔ ✘ ✔ ✔
License EULA CC BY 4.0 Custom terms ² MIT CC BY-SA 4.0

¹ Corrected 2026-08-05. IP2Location's free proxy list (IP2Proxy LITE) is labelled open-proxy only, and every record in the free PX11 file is indeed proxy_type = PUB — but it does not ship zero VPN records, as this note previously claimed. Measured on the free PX11 CSV (2,673,876 rows, downloaded 2026-08-05): provider is populated on 25,963 rows, 25,836 of which also carry city_name, and 8,100 name consumer VPN brands (ExpressVPN, NordVPN, ProtonVPN, Windscribe, IPVanish and others). By that measure it names more provider-attributed VPN ranges than this database's 2,917 (as of 2026-08-05). Our difference is coverage — 16.7M ranges of city geolocation against IP2Proxy's 2.67M open-proxy ranges — not exclusivity.

² IP2Location LITE is distributed under IP2Location's own Terms of Use, which name no Creative Commons licence.

Download

Grab the latest Release:

  • ipgeo-community.mmdb — MaxMind DB format; read it with any maxminddb reader's generic .get() API
  • ipgeo-community.csv.gz — the same records as CSV
  • community-vpn-list.csv.gz — ASN/provider-level VPN ranges (network,provider,basis)
  • SCHEMA.md — field reference
  • MANIFEST.json — version, checksums, row counts

Fields

country_code, country_name, region, city, postal_code, latitude, longitude, timezone, asn, as_org, is_vpn, is_proxy, is_datacenter, ip_type (datacenter / cdn / mobile_carrier / satellite / education / government), sanctioned_region (true on networks in Crimea and Sevastopol; new in the 2026-11-02 release). A field is absent when unknown — coverage varies by field, so check before you build on one. One column is reserved — it carries no data in any release:

  • is_proxy — reserved, never set. The free edition derives its flags from ASN classification and its proxy-ASN list is empty, so this flag is not populated in any record.

And one was empty in the first release:

  • country_name — empty in the 2026-08-03 release; populated with the English name derived from country_code in releases built after 2026-08-05. For that first download, derive it from country_code yourself.

Per-field coverage, measured over all 16,552,600 records (CSV rows) of the 2026-11-02 release: country_code 99.99% · country_name 99.99% · timezone 99.93% · city 94.7% · region 93.4% · asn 92.4% · as_org 92.4% · latitude/longitude 88.6% · ip_type 6.4% · is_datacenter 4.0% · postal_code 1.1% · is_vpn 0.05% · sanctioned_region 0.002% · is_proxy 0%. These numbers move week to week, and the release notes do not restate them, so measure the release you download before you build on a field.

timezone is an IANA name (America/New_York) on every populated record — measured 100.0% on the 2026-08-03 and 2026-11-02 releases. Releases up to 2026-07-31 mixed in bare UTC offsets (+10:00, 54.3% of values at the time) from a coordinate-based deriver that was removed on 2026-07-31; if you still parse those older files, keep testing for / before handing the value to a tz library.

VPN detection belongs to community-vpn-list.csv, not to the MMDB's is_vpn. The list is the authoritative VPN surface — 11,786 ranges (all IPv4; the list carries no IPv6 rows), and it is the only place provider names exist. The MMDB flag is a narrower ASN-level subset: as of the 2026-11-02 release it is set on 4,063 of those 11,786 ranges (34.5%, looking up each range's first address), so reading is_vpn alone under-detects and can never give you a provider name.

Full reference: SCHEMA.md.

Quick start (Python)

Two files, two questions. Use the MMDB for where is this IP, and the VPN list for is this a VPN, and whose — the MMDB's is_vpn is a narrower subset and never carries a provider name, so a VPN check that reads only the MMDB will miss most of the list.

import csv, gzip, ipaddress, maxminddb

# Geolocation → the MMDB.
reader = maxminddb.open_database("ipgeo-community.mmdb")
rec = reader.get("2.56.190.1")       # use .get() — this is not a typed geoip2 City database
print(rec["country_code"], rec.get("city"), rec.get("is_vpn"))

# VPN + provider name → community-vpn-list.csv (IPv4 ranges only; no IPv6 rows).
with gzip.open("community-vpn-list.csv.gz", "rt", newline="") as f:
    vpn_ranges = [(ipaddress.ip_network(r["network"]), r["provider"], r["basis"])
                  for r in csv.DictReader(f)]

def vpn_lookup(ip):
    addr = ipaddress.ip_address(ip)
    return [(str(net), prov or "?", basis) for net, prov, basis in vpn_ranges if addr in net]

print(vpn_lookup("2.56.190.1"))
print(vpn_lookup("2606:4700:4700::1111"))

Actual output against the 2026-11-02 release (the same as on 2026-08-03):

US Dallas None
[('2.56.190.0/24', 'nordvpn', 'cluster')]
[]

That first line is the whole point: the MMDB geolocates 2.56.190.1 to Dallas and reports no is_vpn, while the list names it as NordVPN. Querying an IPv6 address is safe — it simply matches nothing, since the list is IPv4-only.

The MMDB works with any maxminddb reader (Python maxminddb, Go oschwald/maxminddb-golang, Node maxmind) via the generic .get() — same file format as GeoLite2, with our own documented fields. The linear scan above is fine for ~12k ranges; for high-volume lookups load them into a prefix trie instead.

License

CC BY-SA 4.0 — see LICENSE and ATTRIBUTION.txt. You must keep the attribution notices and share derivatives alike. Updated weekly.

Free vs. commercial

The free edition uses ASN / network-block granularity, native flags, and a weekly cadence. Need finer precision or more frequent updates? Those are the commercial WhoisXML API IP Geolocation products.


Trademarks: MaxMind and GeoLite2 are trademarks of MaxMind, Inc.; IP2Location and IP2Proxy are trademarks of Hexasoft Development Sdn. Bhd.; DB-IP is a trademark of its operator; X4BNet/lists_vpn and IPtoASN are the marks of their respective owners. This project is independent of, and not affiliated with or endorsed by, any of them.

About

Free IP geolocation database with VPN flags, provider-named VPN list, and ip_type infrastructure classification (CC BY-SA 4.0). Updated weekly.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages