🔎 Public IP Address Lookup and Geolocation Information

public-ip-address is a simple Rust library for performing public IP lookups from over a dozen of various services.

It provides a unified interface to fetch public IP address and geolocation information from multiple providers. Arbitrary IP address lookup and access API keys are supported for certain providers. The library provides an asynchronous and blocking interfaces to make it easy to integrate with other async codebase.

The library also includes caching functionality to improve performance for repeated lookups and minimize reaching rate-limiting thresholds. The cache file can be encrypted when enabled through a feature flag for additional privacy.

Usage

Add the following to your Cargo.toml file:

[dependencies]
public-ip-address = { version = "0.4" }
with cache encryption enabled
public-ip-address = { version = "0.4", features = ["encryption"] }
with async disabled
public-ip-address = { version = "0.4", features = ["blocking"] }
for targets that do not support openssl
public-ip-address = { version = "0.4", default-features = false, features = ["rustls-tls"] }

Example

The simplest way to use this library is to call the perform_lookup() function, which returns a Result with a LookupResponse.

use std::error::Error;
#[tokio::main] async fn main() -> Result<(), Box<dyn Error>> {     // Perform my public IP address lookup     let result = publicipaddress::perform_lookup(None).await?;     println!("{}", result);     Ok(()) }

With blocking interface enabled:

use std::error::Error;
fn main() -> Result<(), Box<dyn Error>> {     // Perform my public IP address lookup     let result = publicipaddress::perform_lookup(None)?;     println!("{}", result);     Ok(()) }

More examples can be found in the examples directory. And run them with the following command:

cargo run --example <example_name>

Running the examples with the blocking feature enabled:

cargo run --example <example_name> --features blocking

Providers

| Provider | URL | Rate Limit | API Key | Target Lookup | | --- | --- | --- | --- | --- | | FreeIpApi | https://freeipapi.com | 60 / minute | ✔️ | ✔️ | | IfConfig | https://ifconfig.co | 1 / minute | | ✔️ | | IpInfo | https://ipinfo.io | 50000 / month | ✔️ | ✔️ | | MyIp | https://my-ip.io | ? / day | ️ | ️ | | IpApiCom | https://ip-api.com | 45 / minute | | ✔️ | | IpWhoIs | https://ipwhois.io | 10000 / month | ️ | ✔️ | | IpApiCo | https://ipapi.co | 30000 / month | | ✔️ | | IpApiIo | https://ip-api.io | ? / day | ✔️ | ✔️ | | IpBase | https://ipbase.com | 10 / hour | ✔️ | ✔️ | | IpLocateIo | https://iplocate.io | 50 / day | ✔️ | ✔️ | | IpLeak | https://ipleak.net | ? / day | ️ | ✔️ | | Mullvad | https://mullvad.net | ? / day | ️ | ️ | | AbstractApi | https://abstractapi.com | 1000 / day | ✔️ | ✔️ | | IpGeolocation | https://ipgeolocation.io | 1000 / day | ✔️ | ✔️ | | IpData | https://ipdata.co | 1500 / day | ✔️ | ✔️ | | Ip2Location | https://ip2location.io | 50000 / month | ✔️ | ✔️ | | MyIpCom | https://myip.com | unlimited | ️ | ️ | | GetJsonIp | https://getjsonip.com | unlimited | ️ | ️ | | Ipify | https://www.ipify.org | unlimited | ️ | ️ | | IpQuery | https://ipquery.io | unlimited | | ✔️ |

Roadmap

• [x] Initial release
• [x] Add more providers
• [x] Add support for additional providers with API key
• [x] Add reverse lookup feature
• [x] Add asynchronous and synchronous interface support
• [ ] Bulk lookup
• [ ] Offline reverse lookup

License

Licensed under either of

• Apache License, Version 2.0