Simple client for the IPLocate API
Get Started
$ dotnet add package IPLocateIO.ClientReadme
IPLocate Geolocation Client for .NET
A C# client for the IPLocate.io geolocation API. Look up detailed geolocation and threat intelligence data for any IP address:
- IP geolocation: IP to country, IP to city, IP to region/state, coordinates, timezone, postal code
- ASN information: Internet service provider, network details, routing information
- Privacy & threat detection: VPN, proxy, Tor, hosting provider detection
- Company information: Business details associated with IP addresses - company name, domain, type (ISP/hosting/education/government/business)
- Abuse contact: Network abuse reporting information
- Hosting detection: Cloud provider and hosting service detection using our proprietary hosting detection engine
See what information we can provide for your IP address.
Getting started
You can make 1,000 free requests per day with a free account. For higher plans, check out API pricing.
Requirements
- ✅ .NET 6.0+
- ✅ .NET 7.0
- ✅ .NET 8.0
- ✅ .NET Standard 2.1
- API Key from IPLocate.io
[!NOTE] ❌ Not compatible with .NET Framework (which only supports .NET Standard 2.0)
Installation
Using .NET CLI
dotnet add package IPLocateIO.Client
Using NuGet Package Manager
NuGet\Install-Package IPLocateIO.Client
Using Paket CLI
paket add IPLocateIO.Client
Authentication
Get your free API key from IPLocate.io, and pass it to the IpLocateClientFactory.Client method:
IPLocateClient client = IPLocateClientFactory.Client("YOUR_API_KEY");
Quick start
using IPLocate;
var client = IPLocateClientFactory.Client("YOUR_API_KEY");
var result = await client.LookupCurrentIpAsync();
Console.WriteLine($"IP: {result.Ip}, Country: {result.Country}");
Dependency Injection
services.AddHttpClient<IPLocateClient>((sp, http) =>
{
var opts = sp.GetRequiredService<IOptions<MyApiOptions>>();
http.BaseAddress = new Uri(opts.Value.BaseUrl);
http.DefaultRequestHeaders.Add("X-Api-Key", opts.Value.ApiKey);
http.DefaultRequestHeaders.Add("Accept", "application/json");
http.DefaultRequestHeaders.Add("User-Agent", "IPLocateClient/1.0.0");
});
Caching
Quick start
using IPLocate;
var client = IPLocateClientFactory.Client(apiKey:"YOUR_API_KEY", cacheDuration: TimeSpan.FromSeconds(15));
var result = await client.LookupCurrentIpAsync();
Console.WriteLine($"IP: {result.Ip}, Country: {result.Country}");
Dependency Injection
public static void AddIPLocateClient(this IServiceCollection services)
{
services.AddHttpClient<IPLocateClient>((sp, http) =>
{
var opts = sp.GetRequiredService<IOptions<MyApiOptions>>();
http.BaseAddress = new Uri(opts.Value.BaseUrl);
http.DefaultRequestHeaders.Add("X-Api-Key", opts.Value.ApiKey);
http.DefaultRequestHeaders.Add("Accept", "application/json");
http.DefaultRequestHeaders.Add("User-Agent", "IPLocateClient/1.0.0");
}).AddHttpMessageHandler((sp) =>
{
var opts = sp.GetRequiredService<IOptions<MyApiOptions>>();
return new CacheDelegatingHandler(opts.Value.cacheDuration);
});
}
API reference
For complete API documentation, visit iplocate.io/docs.
License
This project is licensed under the MIT License - see the LICENSE file for details
Testing
To run tests for this C# library:
dotnet test