IP2Location SDKs & Libraries: Official & Community Integrations (2026)

SDKs overview

IP2Location offers a range of Software Development Kits (SDKs) and libraries designed to facilitate the integration of its IP geolocation services into various applications. These tools are available for both its downloadable databases and its web service API, allowing developers to choose an integration method based on their specific infrastructure and performance requirements. The SDKs typically handle tasks such as parsing IP addresses, performing lookups against local databases or making API calls, and returning structured geolocation data, including country, region, city, latitude, longitude, and other IP intelligence attributes. The goal of these SDKs is to reduce the implementation effort and provide a consistent interface for accessing IP2Location's data across different programming environments.

Developers can access comprehensive documentation and download links for the various SDKs directly from the IP2Location developer resources. These resources detail installation procedures, API methods, and code examples to assist with integration. The availability of multiple language-specific libraries supports a broad developer base, enabling applications built in popular languages to leverage IP2Location's data without extensive custom parsing or API interaction logic.

Official SDKs by language

IP2Location provides official SDKs and libraries across a spectrum of programming languages, maintaining direct support and updates for these implementations. These official SDKs abstract the complexities of IP lookup operations, whether against a local IP2Location database file or the IP2Location Web Service. Each SDK is tailored to the conventions and package management systems of its respective language, aiming to offer a native integration experience. The following table summarizes the key official SDKs, their typical package names, and common installation methods.

Installation

Installing an IP2Location SDK typically involves using the package manager specific to the chosen programming language. The process generally includes adding a dependency to your project configuration or executing a command-line instruction to download and install the library. Once installed, the library or SDK can be imported into your code, allowing access to its functions for IP lookup.

PHP (Composer)

For PHP, the database library can be installed via Composer:

composer require ip2location/ip2location-php

For the web service, use:

composer require ip2location/ip2location-web-service-php

More details are available on the PHP developer page.

Java (Maven/Gradle)

For Java projects, include the dependency in your pom.xml (Maven) or build.gradle (Gradle) file.

Maven pom.xml:

<dependency>
    <groupId>com.ip2location</groupId>
    <artifactId>ip2location-java</artifactId>
    <version>X.Y.Z</version>
</dependency>

Gradle build.gradle:

implementation 'com.ip2location:ip2location-java:X.Y.Z'

Replace X.Y.Z with the latest version. Consult the Java developer resources for current versions and web service specifics.

Python (pip)

Python libraries are installed using pip:

pip install IP2Location

For the web service:

pip install IP2LocationWebService

Further Python examples are on the IP2Location Python docs.

Node.js (npm)

Node.js modules are installed via npm:

npm install ip2location-nodejs

For the web service:

npm install ip2location-web-service-nodejs

Refer to the Node.js integration guide for details.

Go

Go modules are installed using go get:

go get github.com/ip2location/ip2location-go

The Go SDK documentation provides more information.

C# (.NET / NuGet)

For C# .NET projects, the library is installed via NuGet Package Manager:

Install-Package IP2Location.IP2Location

For the web service:

Install-Package IP2Location.IP2LocationWebService

The C# developer page has additional guidance.

Quickstart example

This quickstart demonstrates how to use the IP2Location Python SDK to perform a local database lookup. Before running this code, ensure you have an IP2Location database file (e.g., IP2LOCATION-LITE-DB1.BIN) downloaded and accessible.

import IP2Location

# Initialize IP2Location object with the database file path
# Replace 'path/to/IP2LOCATION-LITE-DB1.BIN' with your actual file path
database = IP2Location.IP2Location()
database.open('path/to/IP2LOCATION-LITE-DB1.BIN')

# IP address to lookup
ip_address = '8.8.8.8' # Google's public DNS server

# Perform the lookup
record = database.get_all(ip_address)

# Print the results
if record:
    print(f"IP Address: {record.ip}")
    print(f"Country Code: {record.country_short}")
    print(f"Country Name: {record.country_long}")
    print(f"Region Name: {record.region}")
    print(f"City Name: {record.city}")
    print(f"Latitude: {record.latitude}")
    print(f"Longitude: {record.longitude}")
    print(f"Time Zone: {record.timezone}")
else:
    print(f"No record found for IP: {ip_address}")

# Close the database connection when done
database.close()

For web service integration, the approach would involve initializing a web service client with an API key and then calling a lookup method, as detailed in the IP2Location Web Service documentation.

Community libraries

While IP2Location provides official SDKs for many popular languages, the open-source community may develop and maintain additional libraries or connectors. These community-contributed projects can sometimes offer alternative approaches, specialized features, or support for less common programming environments not directly covered by official SDKs. However, community libraries typically do not carry the same level of official support or guarantees as the vendor-maintained versions. Developers considering community libraries should review their documentation, issue trackers, and contribution history to assess their stability and maintenance status.

For instance, developers working with environments like Google App Engine or serverless functions might find community wrappers that streamline deployment or specific data handling. Integrating a third-party library, whether official or community-driven, requires careful consideration of dependencies and potential security implications, as outlined by general best practices for software security. Always prioritize libraries with active maintenance and a clear understanding of their underlying mechanisms. The primary source for official and recommended integrations remains the IP2Location developer portal.