# IP2Location - Complete Product, Database, API, and Integration Reference Index

> IP2Location provides non-intrusive IP geolocation database technology, proxy and VPN detection, WHOIS domain lookups, and developer APIs. It enables businesses to map IPv4 and IPv6 addresses to detailed geographic locations, network parameters, ISP attributes, and security risk indicators.

---

## 1. Commercial IP Geolocation Databases (DB1 - DB26)

URL: https://www.ip2location.com/database/ip2location
Description: Comprehensive offline binary database files (.BIN) updated on bi-weekly basis. Supports both IPv4 and IPv6 address spaces in unified or separate database packages. Available across 26 incremental feature levels:

- **DB1**: Country Database (Country Code, Country Name)
- **DB2**: Country + Region + City
- **DB3**: Country + Region + City + Latitude + Longitude
- **DB4**: Country + Region + City + Latitude + Longitude + ZIP Code
- **DB5**: Country + Region + City + Latitude + Longitude + Time Zone
- **DB6**: Country + Region + City + Latitude + Longitude + Time Zone + ISP
- **DB7**: Country + Region + City + Latitude + Longitude + Time Zone + ISP + Domain Name
- **DB8**: Country + Region + City + Latitude + Longitude + Time Zone + ISP + Domain + Usage Type
- **DB9**: Country + Region + City + Latitude + Longitude + ZIP Code + Time Zone
- **DB10**: Country + Region + City + Latitude + Longitude + ZIP Code + Time Zone + ISP + Domain
- **DB11**: Country + Region + City + Latitude + Longitude + ZIP Code + Time Zone + ISP + Domain + Timezone + Usage Type
- **DB12**: Adds Connection Speed, IDD Code, Area Code
- **DB13**: Adds Weather Station Code and Weather Station Name
- **DB14**: Adds Mobile Country Code (MCC), Mobile Network Code (MNC), and Mobile Brand Name
- **DB15**: Adds Elevation (meters above sea level)
- **DB16**: Adds Usage Type classification (e.g., Commercial, Residential, University, Government)
- **DB17**: Adds Address Type (Unicast, Anycast, Multicast)
- **DB18**: Adds Category (IAB Content Categories)
- **DB19**: Adds District / Sub-region boundaries
- **DB20**: Adds Autonomous System Number (ASN) and AS Name
- **DB21**: Adds Edge Node / CDN Indicators
- **DB22**: Adds Fraud Risk Score calculations
- **DB23**: Adds Precise Geolocation Coordinates & Accuracy Radius
- **DB24**: Adds Residential Proxy & Commercial Host identification
- **DB25**: Adds Administrative District & City Subdivision data
- **DB26**: Complete Geolocation Suite (Includes all parameters from DB1 through DB25): Fraud Risk Score, Address Type, Category, District, Autonomous System (AS) Number, AS Name, and all prior fields.

---

## 2. Commercial IP2Proxy Detection Databases (PX1 - PX11)

URL: https://www.ip2location.com/database/ip2proxy
Description: Specialized offline binary databases for identifying anonymous proxies, VPN providers, Tor exit nodes, data center hosters, web hosters, search engine crawlers, residential proxies, and security threats:

- **PX1**: Proxy Indicator (YES/NO boolean check)
- **PX2**: Proxy Type (VPN, TOR, DCH, PUB, WEB, SES, RES, CP)
- **PX3**: Adds Country, Region, City
- **PX4**: Adds ISP Name
- **PX5**: Adds Domain Name
- **PX6**: Adds Usage Type classification
- **PX7**: Adds Autonomous System Number (ASN) and AS Name
- **PX8**: Adds Threat Level / Risk Level Assessment
- **PX9**: Adds Provider Name (e.g., NordVPN, ExpressVPN, Surfshark)
- **PX10**: Adds Fraud Risk Score
- **PX11**: Complete Proxy & Threat Detection Suite (Includes all PX1 through PX10 parameters)

---

## 3. Free LITE Databases (IP2Location, IP2Proxy, ASN)

URL: https://www.ip2location.com/database/lite
Description: Consolidated free database portal providing access to three distinct LITE datasets under a single signup. Available for personal and commercial projects without licensing fees in BIN, CSV, and CIDR formats, updated semi-monthly.

### 3.1 IP2Location LITE Database
- **Scope**: Free IP Geolocation lookup package.
- **Precision**: Subnet-level precision (`1.2.3.x` mask), ~98% country accuracy, and ~60% city accuracy (>1M records).
- **Data Fields**: Country, Region, City, Latitude, Longitude, ZIP Code, and Time Zone.

### 3.2 IP2Proxy LITE Database
- **Scope**: Free threat intelligence and proxy identification.
- **Data Fields**: VPN & Proxy detection, TOR exit node detection, Hosting provider information, ISP, and Domain.

### 3.3 ASN LITE Database
- **Scope**: Free Autonomous System Number and network routing database.
- **Data Fields**: Autonomous System Number (ASN), Organization Name, Network Range, and Country.

### 3.4 Key LITE vs. Commercial Specifications
- **Price**: Free (Requires attribution).
- **IP Address Depth**: Subnet level (`1.2.3.x`) vs. Full IP level (`1.2.3.4`) in Commercial.
- **Update Frequency**: Semi-monthly.
- **SDK & API Compatibility**: Fully compatible with all 30 open-source programming libraries (BIN format).

---

## 4. API & Web Service Offerings

### 4.1 IP2Location REST Web Service (Legacy Endpoint)
URL: https://www.ip2location.com/web-service/ip2location
Description: Legacy credit-based REST API for real-time IP geolocation without local binary database hosting.
- Query Endpoint: `https://api.ip2location.com/v2/`
- Formats: JSON, XML
- Parameters: `ip`, `key`, `package` (WS1 to WS25), `format`, `addon`, `lang`
- Note: Still actively maintained for legacy credit key balances and existing SDK integration support. IP2Location.io is recommended for new integrations.

### 4.2 IP2Proxy Web Service (Legacy Endpoint)
URL: https://www.ip2location.com/web-service/ip2proxy
Description: Legacy credit-based REST API for dynamic detection of anonymous proxies, VPNs, TOR exit nodes, and threat levels.
- Query Endpoint: `https://api.ip2proxy.com/`
- Formats: JSON, XML
- Parameters: `ip`, `key`, `package` (PX1 to PX11), `format`
- Note: Maintained for legacy credit users. IP2Location.io is recommended for new proxy API integrations.

### 4.3 IP2Location.io API Integration (Recommended Modern Platform)
URL: https://www.ip2location.io
Description: Primary cloud-native REST API platform offering low-latency IP geolocation, proxy detection, WHOIS queries, domain status monitoring, and security risk scores.
- Query Endpoint: `https://api.ip2location.io/v1/`
- Features: Real-time API key management, monthly request-based subscription tiers, free plan tier, automatic IPv4/IPv6 support, and unified WHOIS data response payloads.

---

## 5. Official Software Development Kits (SDKs) & Programming Libraries

URL: https://www.ip2location.com/development-libraries
Description: Official open-source reader libraries for parsing binary (.BIN) database files natively in application memory without external SQL dependencies:

- **Python**: `pip install IP2Location` / `pip install IP2Proxy` | https://github.com/ip2location/ip2location-python
- **Node.js**: `npm install ip2location-nodejs` | https://github.com/ip2location/ip2location-nodejs
- **PHP**: `composer require ip2location/ip2location-php` | https://github.com/ip2location/ip2location-php
- **Java**: Maven artifact `com.ip2location:ip2location-java` | https://github.com/ip2location/ip2location-java
- **C# / .NET**: NuGet package `IP2Location.IPGeolocation` | https://github.com/ip2location/ip2location-dotnet
- **Go**: `go get github.com/ip2location/ip2location-go/v9` | https://github.com/ip2location/ip2location-go
- **C / C++**: Native C reader library (`libIP2Location`) | https://github.com/ip2location/ip2location-c
- **Ruby**: `gem install ip2location_ruby` | https://github.com/ip2location/ip2location-ruby
- **Rust**: `cargo add ip2location` | https://github.com/ip2location/ip2location-rust
- **Swift / iOS**: `IP2LocationSwift` package | https://github.com/ip2location/ip2location-swift
- **Perl**: `Net::IP2Location` module via CPAN | https://github.com/ip2location/ip2location-perl
- **R**: `ip2location` package via CRAN | https://github.com/ip2location/ip2location-r

---

## 6. Web Server Modules, CMS Plugins & Framework Extensions

URL: https://www.ip2location.com/plugins
Description: Ready-made integrations to inspect visitor IPs at the web server layer, CDN level, or application middleware:

- **Apache HTTP Server**: `mod_ip2location` C module for direct HTTP environment variable injection.
- **Nginx Web Server**: `ngx_http_ip2location_module` module for native Nginx configuration rules.
- **IIS Web Server**: HTTP Module for ASP.NET / IIS web applications.
- **Cloudflare Workers / Edge**: Cloudflare Workers integration script for edge-side IP filtering and geo-redirects.
- **WordPress Plugin**: IP2Location Redirection and IP2Location Country Blocker plugins.
- **Content Management Systems**: Official modules for Magento, Drupal, Joomla, OpenCart, and WHMCS.
- **Framework Middleware**: Native packages for Laravel, Django, Ruby on Rails, and Express.js.

---

## 7. Automated Database Download & Update Scripts

URL: https://www.ip2location.com/free/downloader-script
Description: Automation scripts to fetch and unpack monthly updated database files via API download tokens:

- **Shell / Bash Script**: `ip2location-downloader.sh` for Linux cron jobs.
- **Python Script**: Python downloader script supporting automated checksum verification (.md5) and decompression (.zip).
- **PHP Automation**: PHP script for scheduled background database replacement.

---

## 8. Free Web Utilities & Diagnostic Tools

- **Interactive IP Lookup Demo**: https://www.ip2location.com/demo
- **Visitor Redirection Code Generator**: https://www.ip2location.com/free/visitor-redirection
- **CIDR / IP Range Country List Generator**: https://www.ip2location.com/free/visitor-blocker
- **Traceroute & Email Tracer Utilities**: https://www.ip2location.com/free/traceroute
- **IFrame Developer Widget**: https://www.ip2location.com/free/widgets

---

## 9. Licensing, Pricing & Support Resources

- **Standard Licensing**: https://www.ip2location.com/buy-standard-license (Single-server annual update subscription for DB1–DB26 and PX1–PX11).
- **Site Licensing**: https://www.ip2location.com/buy-online (Unlimited internal server deployment license for enterprise applications).
- **OEM / Redistribution Licensing**: Enterprise licenses for embedding binary databases inside commercial software packages.
- **Frequently Asked Questions (FAQ)**: https://www.ip2location.com/faq
- **Blog & Tutorials**: https://blog.ip2location.com
- **Contact & Support**: https://www.ip2location.com/contact