IpApiIo 1.0.0

IpApiIo — Official .NET client for ip-api.io

The official .NET 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.

Zero package dependencies — built on HttpClient and System.Text.Json, fully async.

Install

dotnet add package IpApiIo

Quickstart

using IpApiIo;

using var client = new IpApiClient(apiKey: "YOUR_API_KEY"); // free key at https://ip-api.io

// Where is this IP, and is it risky?
var info = await client.LookupAsync("8.8.8.8");
Console.WriteLine(info.Location.Country);            // "United States"
Console.WriteLine(info.SuspiciousFactorsInfo.IsVpn); // False

var risk = await client.RiskScoreAsync("8.8.8.8");
Console.WriteLine($"{risk.Score} {risk.RiskLevel}"); // 0 low

var email = await client.ValidateEmailAsync("user@example.com");
Console.WriteLine(email.Reachable);                  // "yes"

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 — LookupAsync, LookupBatchAsync
• Email validation & verification — EmailInfoAsync, ValidateEmailAsync, ValidateEmailBatchAsync
• Fraud detection & risk scoring — RiskScoreAsync, EmailRiskScoreAsync, IpReputationAsync
• VPN, proxy & Tor detection — TorCheckAsync, SuspiciousFactorsInfo
• ASN & DNS lookups — AsnAsync, WhoisAsync, ReverseDnsAsync, ForwardDnsAsync, MxRecordsAsync
• Domain age checker — DomainAgeAsync, DomainAgeBatchAsync
• Errors, rate limits & usage — exception types, RateLimitAsync, UsageSummaryAsync

Methods

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

All responses are fully typed (IpInfo, RiskScore, AdvancedEmailValidation, …). Every method accepts an optional CancellationToken.

Error handling

The client throws typed exceptions and never retries — RateLimitException.Reset tells you when your quota renews:

try
{
    await client.LookupAsync("8.8.8.8");
}
catch (RateLimitException e)
{
    Console.WriteLine($"limit={e.Limit} remaining={e.Remaining} resetsAt={e.Reset}");
}
catch (AuthenticationException)
{
    Console.WriteLine("invalid API key");
}

See docs/error-handling.md for the full exception 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

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