IP2Location is a leading IP geolocation provider, offering solutions for IP Gelocation Lookup and Proxy Detection.
IP2Location IP Geolocation is an accurate database solution that allows you to determine the geographical location of an IP address. It maps IP addresses to a wide range of data fields such as country, region or state, district, city, latitude and longitude, ZIP/Postal code, time zone, Internet Service Provider (ISP) or company name, domain name, net speed, area code, weather station code, weather station name, mobile country code (MCC), mobile network code (MNC) and carrier brand, elevation, usage type, address type, IAB category and ASN of IP address.
IP2Proxy Proxy Detection contains proxy-related information including country, region, city, ISP, domain, usage type, ASN, last seen date, threat reported, VPN provider name and fraud score. It detects anonymous proxy, VPNs (VPN), open proxies (PUB), web proxies (WEB), Tor exit nodes (TOR), data center and hosting IPs (DCH), search engine spiders (SES), residential proxies (RES), consumer privacy networks (CPN), and enterprise private networks (EPN).
This repository contains sample datasets for IP2Location and IP2Proxy—an ideal starting point for developers to explore the data format, field structure, and integration workflows
| Database Product | Description | Sample Database |
|---|---|---|
| IP2Location IP Geolocation | There are a total of 26 package databases that help businesses identify the geographic location of their website visitors. | https://github.com/ip2location/sample-databases/tree/main/IP2Location |
| IP2Proxy Proxy Detection | There are a total of 12 package databases that help businesses to detect IP anonymizers. | https://github.com/ip2location/sample-databases/tree/main/IP2Proxy |
There are 26 database samples for IP2Location IP Geolocation and 12 database samples for IP2Proxy Proxy Detection. Please visit each folder to learn more about the databases. In the each folder, you will find:
- Sample datasets available for both IPv4 and IPv6
- Detailed field descriptions and dataset structure
- Useful guides, resources, articles, and example code snippets
IP2Location delivers a precise, modular IP geolocation solution that maps any IPv4 or IPv6 address to a comprehensive set of data fields—from basic geographic information to advanced network intelligence. Organized into 26 distinct database packages, the system lets you customize integration based on the level of granularity you require. Supported formats include BIN, CSV and CIDR.
| DB | Country | Region & City | Latitude & Longitude | ZIP Code | ISP | Domain | Time Zone | Net Speed | Area Code | Weather | Mobile | Elevation | Usage Type | Address Type | Category | District | ASN |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DB1 | ✔ | ||||||||||||||||
| DB2 | ✔ | ✔ | |||||||||||||||
| DB3 | ✔ | ✔ | |||||||||||||||
| DB4 | ✔ | ✔ | ✔ | ✔ | |||||||||||||
| DB5 | ✔ | ✔ | ✔ | ||||||||||||||
| DB6 | ✔ | ✔ | ✔ | ✔ | |||||||||||||
| DB7 | ✔ | ✔ | ✔ | ✔ | |||||||||||||
| DB8 | ✔ | ✔ | ✔ | ✔ | ✔ | ||||||||||||
| DB9 | ✔ | ✔ | ✔ | ✔ | |||||||||||||
| DB10 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |||||||||||
| DB11 | ✔ | ✔ | ✔ | ✔ | ✔ | ||||||||||||
| DB12 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ||||||||||
| DB13 | ✔ | ✔ | ✔ | ✔ | ✔ | ||||||||||||
| DB14 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |||||||||
| DB15 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |||||||||||
| DB16 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ||||||||
| DB17 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |||||||||||
| DB18 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |||||||
| DB19 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |||||||||||
| DB20 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ||||||
| DB21 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ||||||||||
| DB22 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |||||
| DB23 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ||||||||||
| DB24 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ||||
| DB25 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ||
| DB26 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
The IP2Proxy Proxy Detection Database is a specialized dataset designed to identify IP addresses linked to anonymized or non-legitimate traffic sources. It detects a broad spectrum of proxy types, including VPNs (VPN), open proxies (PUB), web proxies (WEB), Tor exit nodes (TOR), data center and hosting IPs (DCH), search engine spiders (SES), residential proxies (RES), consumer privacy networks (CPN), and enterprise private networks (EPN).
Available in 12 structured packages with varying levels of granularity—such as autonomous system number, last seen date, threat type, provider name, and fraud score—IP2Proxy empowers developers, analysts, and security platforms to programmatically flag, filter, or block potentially high-risk IP addresses with accuracy and efficiency.
| Proxy Type | Description | Anonymity |
|---|---|---|
| VPN | Virtual Private Networks: A Virtual Private Network (VPN) is a service that provides users with a publicly accessible server to conceal their IP address. | High |
| TOR | Tor Exit Nodes: The Tor Project is an open network used by those seeking anonymity via a free, worldwide, volunteer overlay network that consists of more thousands relays. | High |
| DCH | Hosting Provider, Data Center or Content Delivery Network: As hosting providers and data centers can contribute to anonymity, the IP2Proxy database flags IP addresses associated with them. | Low |
| PUB | Public Proxies: These services make connection requests on a user's behalf. Proxy server software can be configured by the administrator to listen on a specified port. They differ from VPNs in that proxies usually have limited functions compared to VPNs. | High |
| WEB | Web Proxies: These are web services that make HTTP requests on behalf of a user. They differ from VPNs or Public Proxies as they operate as simple web proxies rather than at the IP address and other ports level. | High |
| SES | Search Engine Robots: These are services that perform crawling or scraping on a website, such as the search engine spider or bot engine. | Low |
| RES | Residential Proxies: These services offer users proxy connections through residential ISP with or without consents of peers to share their idle resources. Only available with PX10 - PX12 | Medium |
| CPN | Consumer Privacy Networks: These services ensure encrypted traffic from the user's browser by routing internet requests through relays, concealing the IP address, location, and browsing activity. Only available with PX11 & PX12 | Low |
| EPN | Enterprise Private Networks: Services like SASE or SD-WAN combine network security functions with wide-area networking (WAN) capabilities to meet the secure remote access needs of organizations. Only available with PX11 & PX12 | Low |
| Product | Country | Proxy Type | Region & City | ISP | Domain | Usage Type | ASN | Last Seen | Threat | Residential Proxy | Provider | Fraud Score |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| PX1 | ✔ | |||||||||||
| PX2 | ✔ | 6 | ||||||||||
| PX3 | ✔ | 6 | ✔ | |||||||||
| PX4 | ✔ | 6 | ✔ | ✔ | ||||||||
| PX5 | ✔ | 6 | ✔ | ✔ | ✔ | |||||||
| PX6 | ✔ | 6 | ✔ | ✔ | ✔ | ✔ | ||||||
| PX7 | ✔ | 6 | ✔ | ✔ | ✔ | ✔ | ✔ | |||||
| PX8 | ✔ | 6 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ||||
| PX9 | ✔ | 6 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |||
| PX10 | ✔ | 7 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ||
| PX11 | ✔ | 9 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |
| PX12 | ✔ | 9 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Proxy types:
- 6: VPN, TOR, DCH, PUB, WEB, SES
- 7: VPN, TOR, DCH, PUB, WEB, SES, RES
- 9: VPN, TOR, DCH, PUB, WEB, SES, RES, CPN, EPN
Each sample may includes:
-
CSV: Comma-delimited text file with decimal ranges for direct database import or manual inspection.
-
BIN: IP2Location binary format for use with official IP2Location or IP2Proxy libraries.
-
CIDR: Comma-delimited text file with CIDR ranges, useful for firewall rules, network scanning, log analysis, and infrastructure automation.
For more information, please refer to the IP2Location.com official documentation at https://www.ip2location.com/documentation/main, which provides comprehensive details and usage guidelines.
Alternatively, you may explore the articles at https://blog.ip2location.com for additional insights and practical examples.
IP2Location.com offers extensive databases for IP geolocation. It enables users to precisely identify the geographical location of IP addresses, providing details such as country, region, city, district, latitude, longitude, ZIP code, time zone, connection speed, ISP, domain name, IDD country code, area code, weather station code and name, mobile carrier, elevation, usage type, address type, advertising category, and autonomous system.
These databases are invaluable for various use cases and applications, including website traffic analysis, fraud prevention, and personalized content delivery. By leveraging IP2Location’s data, businesses and developers can enhance their services, improve user experiences, and ensure more secure online interactions. IP2Location solution is available as a database and hosted API. If you are interested in web service instead of database, please visit IP2Location.io for the remote hosted service.
Stay connected with us on Facebook, X and LinkedIn for more insights into IP address data and its powerful applications.