Struct Client 

pub struct Client { /* private fields */ }

Client for the ipdata.info IP geolocation, ASN, and threat-intelligence API.

Build one with Client::new (free tier) or Client::builder (to set an API key, custom base URL, or timeout).

Implementations

impl Client

pub fn new() -> Self

Creates a client targeting the free tier with the default 10s timeout.

Examples found in repository

examples/quickstart.rs (line 9)

fn main() {
    // Free tier — no API key needed. For higher limits + batch, get a free
    // key at https://ipdata.info/register and use Client::builder().api_key("...").
    let client = Client::new();

    let info = client.lookup("8.8.8.8").expect("lookup failed");
    println!(
        "{} is in {:?}, {:?} (ASN {:?} — {:?})",
        info.ip, info.city, info.country, info.asn, info.asn_org
    );

    let threat = client
        .threat_domain("example.com")
        .expect("threat lookup failed");
    println!("example.com listed as a threat: {}", threat.listed);
}

pub fn builder() -> ClientBuilder

Returns a ClientBuilder for configuring an API key, base URL, or timeout.

pub fn base_url(&self) -> &str

Returns the base URL this client sends requests to.

pub fn lookup(&self, ip: &str) -> Result<IpInfo, Error>

Returns the full geolocation record for ip. Pass "" for the caller’s own IP.

Examples found in repository

examples/quickstart.rs (line 11)

fn main() {
    // Free tier — no API key needed. For higher limits + batch, get a free
    // key at https://ipdata.info/register and use Client::builder().api_key("...").
    let client = Client::new();

    let info = client.lookup("8.8.8.8").expect("lookup failed");
    println!(
        "{} is in {:?}, {:?} (ASN {:?} — {:?})",
        info.ip, info.city, info.country, info.asn, info.asn_org
    );

    let threat = client
        .threat_domain("example.com")
        .expect("threat lookup failed");
    println!("example.com listed as a threat: {}", threat.listed);
}

pub fn geo(&self, ip: &str) -> Result<GeoInfo, Error>

Returns the compact geo subset for ip.

pub fn asn(&self, ip: &str) -> Result<AsnBrief, Error>

Returns the compact ASN subset for ip.

pub fn batch(&self, ips: &[&str]) -> Result<Vec<IpInfo>, Error>

Looks up many IPs in a single request. Requires an API key (paid tier); anonymous requests receive 403.

pub fn asn_detail(&self, number: u32) -> Result<Value, Error>

Returns the detailed ASN record (prefixes, peering) as a raw JSON value; the shape is large and only loosely specified.

pub fn asn_whois_history(&self, number: u32) -> Result<Value, Error>

Returns the ASN whois history as a raw JSON value.

pub fn asn_changes(&self) -> Result<Value, Error>

Returns the ASN change feed as a raw JSON value.

pub fn threat_domain(&self, domain: &str) -> Result<ThreatMatch, Error>

Looks up a domain in the threat-intel store.

Examples found in repository

examples/quickstart.rs (line 18)

fn main() {
    // Free tier — no API key needed. For higher limits + batch, get a free
    // key at https://ipdata.info/register and use Client::builder().api_key("...").
    let client = Client::new();

    let info = client.lookup("8.8.8.8").expect("lookup failed");
    println!(
        "{} is in {:?}, {:?} (ASN {:?} — {:?})",
        info.ip, info.city, info.country, info.asn, info.asn_org
    );

    let threat = client
        .threat_domain("example.com")
        .expect("threat lookup failed");
    println!("example.com listed as a threat: {}", threat.listed);
}

pub fn threat_hash(&self, hash: &str) -> Result<ThreatMatch, Error>

Looks up a file hash (md5/sha1/sha256) in the threat-intel store.

pub fn threat_url(&self, url: &str) -> Result<ThreatMatch, Error>

Looks up a URL in the threat-intel store (the server falls back to the URL’s domain on a miss).

Trait Implementations

impl Default for Client

fn default() -> Self

Returns the “default value” for a type.