IPinfo 2.0.2

.NET Standard 2.0
dotnet add package IPinfo --version 2.0.2
NuGet\Install-Package IPinfo -Version 2.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="IPinfo" Version="2.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add IPinfo --version 2.0.2
#r "nuget: IPinfo, 2.0.2"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install IPinfo as a Cake Addin
#addin nuget:?package=IPinfo&version=2.0.2

// Install IPinfo as a Cake Tool
#tool nuget:?package=IPinfo&version=2.0.2

<a href="https://ipinfo.io/"><img src="https://raw.githubusercontent.com/ipinfo/csharp/main/src/IPinfo/icon.png" alt="IPinfo" width="24" /></a> IPinfo C# .NET SDK

License NuGet

This is the official C# .NET SDK for the IPinfo.io IP address API, allowing you to lookup your own IP address, or get any of the following details for other IP addresses:

  • IP geolocation / geoIP data (city, region, country, postal code, latitude and longitude)
  • ASN details (ISP or network operator, associated domain name, and type, such as business, hosting or company)
  • Firmographics data (the name and domain of the business that uses the IP address)
  • Carrier information (the name of the mobile carrier and MNC and MCC for that carrier if the IP is used exclusively for mobile traffic)

Getting Started

You'll need an IPinfo API access token, which you can get by singing up for a free account at https://ipinfo.io/signup.

The free plan is limited to 50,000 requests per month, and doesn't include some of the data fields such as IP type and company data. To enable all the data fields and additional request volumes see https://ipinfo.io/pricing

Installation

This package can be installed from NuGet.

Install using Package Manager
Install-Package IPinfo
Install using the dotnet CLI
dotnet add package IPinfo
Install with NuGet.exe
nuget install IPinfo

Quick Start

// namespace
using IPinfo;
using IPinfo.Models;
// initializing IPinfo client
string token = "MY_TOKEN";
IPinfoClient client = new IPinfoClient.Builder()
    .AccessToken(token)
    .Build();

Usage

// making API call
string ip = "216.239.36.21";
IPResponse ipResponse = await client.IPApi.GetDetailsAsync(ip);
// accessing location details from response
Console.WriteLine($"IPResponse.IP: {ipResponse.IP}");
Console.WriteLine($"IPResponse.City: {ipResponse.City}");
Console.WriteLine($"IPResponse.Company.Name: {ipResponse.Company.Name}");
Console.WriteLine($"IPResponse.Country: {ipResponse.Country}");
Console.WriteLine($"IPResponse.CountryName: {ipResponse.CountryName}");

Synchronous

// making synchronous API call
string ip = "216.239.36.21";
IPResponse ipResponse = client.IPApi.GetDetails(ip);

Country Name Lookup

ipResponse.CountryName will return the country name, whereas ipResponse.Country can be used to fetch the country code.

Additionally ipResponse.IsEU will return true if the country is a member of the European Union (EU).

string ip = "1.1.1.1";

// making API call
IPResponse ipResponse = await client.IPApi.GetDetailsAsync(ip);

// country code, e.g. 'US'
Console.WriteLine($"IPResponse.Country: {ipResponse.Country}");

// country name, e.g. 'United States'
Console.WriteLine($"IPResponse.CountryName: {ipResponse.CountryName}");

// whether part of the EU, e.g. false
Console.WriteLine($"IPResponse.isEU: {ipResponse.isEU}");

Caching

In-memory caching of data is provided by default. Custom implementation of the cache can also be provided by implementing the ICache interface.

Modifying cache options
// namespace
using IPinfo;
using IPinfo.Cache;
long cacheEntryTimeToLiveInSeconds = 2*60*60*24; // 2 days
int cacheSizeMbs = 2;
IPinfoClient client = new IPinfoClient.Builder()
    .AccessToken(token) // pass your token string
    .Cache(new CacheWrapper(cacheConfig => cacheConfig
        .CacheMaxMbs(cacheSizeMbs) // pass cache size in mbs
        .CacheTtl(cacheEntryTimeToLiveInSeconds))) // pass time to live in seconds for cache entry
    .Build();

Bogon Filtering

The Bogon property of the IPResponse object can be used to check if an IP address is a bogon.

// namespace
using IPinfo;
using IPinfo.Models;
string ip = "127.0.0.1";
IPResponse ipResponse = await client.IPApi.GetDetailsAsync(ip);
if (ipResponse.Bogon)
{
    Console.WriteLine($"{ipResponse.IP} is a bogon.");   
}
else
{
    // display ip details
    Console.WriteLine($"IPResponse.IP: {ipResponse.IP}");
    Console.WriteLine($"IPResponse.City: {ipResponse.City}");
    Console.WriteLine($"IPResponse.CountryName: {ipResponse.CountryName}");
}

Samples

Sample codes are also available.

Other Libraries

There are official IPinfo client libraries available for many languages including PHP, Go, Java, Ruby, and many popular frameworks such as Django, Rails and Laravel. There are also many third party libraries and integrations available for our API.

About IPinfo

Founded in 2013, IPinfo prides itself on being the most reliable, accurate, and in-depth source of IP address data available anywhere. We process terabytes of data to produce our custom IP geolocation, company, carrier, VPN detection, hosted domains, and IP type data sets. Our API handles over 40 billion requests a month for 100,000 businesses and developers.

image

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.2 6,003 9/1/2022
2.0.1 3,328 7/15/2022
2.0.0 2,257 6/9/2022
1.1.14 13,725 12/20/2021
1.1.13 13,936 11/10/2021
1.1.12 258 11/5/2021
1.1.11 777 10/27/2021
1.1.9 3,398 7/6/2021
1.1.8 228 7/6/2021
1.1.4 247 7/6/2021
1.1.3 237 7/6/2021
1.1.1 243 7/6/2021
1.0.5.4 338 7/5/2021
1.0.5.3 296 7/5/2021
1.0.5.2 3,834 3/25/2021
1.0.5.1 5,259 9/5/2020
1.0.5 566 8/30/2020
1.0.4.2 381 8/30/2020
1.0.4.1 384 8/30/2020
1.0.4 391 8/30/2020
1.0.3 414 8/30/2020
1.0.2 418 8/30/2020
1.0.1 369 8/10/2020
1.0.0 366 8/9/2020
1.0.0-beta.4 228 8/9/2020
1.0.0-beta.3 253 8/9/2020
1.0.0-beta.2 275 8/9/2020
1.0.0-beta.1 476 8/9/2020

Added IsEU property to check if the country is a member of the European Union (EU).