ip-api-io — Official Rust client for ip-api.io

The official Rust client for the ip-api.io IP intelligence platform. One client covers IP geolocation, email validation and verification (syntax, MX, SMTP deliverability), fraud detection and risk scoring, VPN/proxy/Tor detection, disposable email detection, ASN lookup, WHOIS, reverse DNS, MX records and domain age.

Async by default (reqwest + rustls), fully typed responses, optional blocking feature.

Install

cargo add ip-api-io

Quickstart

use ip_api_io::Client;

#[tokio::main]
async fn main() -> Result<(), ip_api_io::Error> {
    let client = Client::with_api_key("YOUR_API_KEY"); // free key at https://ip-api.io

    let info = client.lookup_ip("8.8.8.8").await?;
    println!("{:?}", info.location.country);          // Some("United States")
    println!("{}", info.suspicious_factors.is_vpn);   // false

    let risk = client.risk_score_ip("8.8.8.8").await?;
    println!("{} {}", risk.score, risk.risk_level);   // 0 low

    Ok(())
}

Synchronous usage with the blocking feature (cargo add ip-api-io --features blocking):

let client = ip_api_io::blocking::Client::with_api_key("YOUR_API_KEY");
let info = client.lookup_ip("8.8.8.8")?;

An API key is required — the API rejects keyless requests with 401. Sign up at ip-api.io for a free key.

Documentation

Each guide documents the methods for one capability, with runnable examples and a link to the matching ip-api.io product page:

• IP geolocation & bulk lookup — lookup, lookup_ip, lookup_batch
• Email validation & verification — email_info, validate_email, validate_email_batch
• Fraud detection & risk scoring — risk_score, risk_score_ip, email_risk_score, ip_reputation
• VPN, proxy & Tor detection — tor_check, suspicious_factors
• ASN & DNS lookups — asn, whois, reverse_dns, forward_dns, mx_records
• Domain age checker — domain_age, domain_age_batch
• Errors, rate limits & usage — the Error enum, rate_limit, usage_summary

Methods

Every method maps to one ip-api.io endpoint and its product page:

Every method has the same signature on blocking::Client, minus .await.

Error handling

The client returns a typed Error enum and never retries — Error::RateLimit's reset field tells you when your quota renews:

match client.lookup_ip("8.8.8.8").await {
    Ok(info) => println!("{info:?}"),
    Err(ip_api_io::Error::RateLimit { limit, remaining, reset, .. }) => {
        println!("limit={limit:?} remaining={remaining:?} resets_at={reset:?}");
    }
    Err(ip_api_io::Error::Authentication { .. }) => println!("invalid API key"),
    Err(other) => println!("{other}"),
}

See docs/error-handling.md for the full Error taxonomy.

Links

• Website: https://ip-api.io
• API reference: https://ip-api.io/api-docs.html
• OpenAPI spec: https://ip-api.io/openapi.json
• Get a free API key: https://ip-api.io

ip-api-io is the official client for ip-api.io. It is not affiliated with ip-api.com or ipapi.com.