IPinfo 3.0.0

dotnet add package IPinfo --version 3.0.0
NuGet\Install-Package IPinfo -Version 3.0.0
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="3.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add IPinfo --version 3.0.0
#r "nuget: IPinfo, 3.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. 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=3.0.0

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

<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 look up your own IP address, or get any of the following details for other IP addresses:

  • IP geolocation (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 signing 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), response.CountryFlag will return the emoji and Unicode of the country's flag, response.CountryCurrency will return the code and symbol of the country's currency ,and response.Continent will return the code and name of the continent. response.CountryFlagURL will return a public link to the country's flag image as an SVG which can be used anywhere.

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}");

// country flag emoji, e.g. "US" -> "πŸ‡ΊπŸ‡Έ"
Console.WriteLine($"IPResponse.CountryFlag.Emoji: {ipResponse.CountryFlag.Emoji}");

// country flag url, e.g. "US" -> "https://cdn.ipinfo.io/static/images/countries-flags/US.svg"
Console.WriteLine($"IPResponse.CountryFlagurl: {ipResponse.CountryFlagURL}");

// country flag unicode, e.g. "US" -> "U+1F1FA U+1F1F8"
Console.WriteLine($"IPResponse.CountryFlag.Unicode: {ipResponse.CountryFlag.Unicode}");

// currency code, e.g. "US" -> "USD"
Console.WriteLine($"IPResponse.CountryCurrency.Code: {ipResponse.CountryCurrency.Code}");

// currency symbol, e.g. "US" -> "$"
Console.WriteLine($"IPResponse.CountryCurrency.Symbol: {ipResponse.CountryCurrency.Symbol}");

// continent code, e.g. "US" -> "NA"
Console.WriteLine($"IPResponse.Continent.Code: {ipResponse.Continent.Code}");

// continent name, e.g. "US" -> "North America"
Console.WriteLine($"IPResponse.Continent.Name: {ipResponse.Continent.Name}");

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}");
}

Thread Safety

This library is thread safe when using default components.

If you decide to replace the cache implementation with your own, you must guarantee thread safety within that library in regard to cache manipulations.

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 Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on IPinfo:

Repository Stars
codesiddhant/Jasmin-Ransomware
Jasmin Ransomware is an advanced red team tool (WannaCry Clone) used for simulating real ransomware attacks. Jasmin helps security researchers to overcome the risk of external attacks.
mysteryx93/HanumanInstituteApps
432Hz Player, 432Hz Batch Converter, Powerliminals Player, Yang YouTube Downloader
Version Downloads Last updated
3.0.0 8,389 12/7/2023
2.1.0 103,372 1/25/2023
2.0.2 40,970 9/1/2022
2.0.1 6,796 7/15/2022
2.0.0 2,929 6/9/2022
1.1.14 23,452 12/20/2021
1.1.13 14,437 11/10/2021
1.1.12 597 11/5/2021
1.1.11 1,084 10/27/2021
1.1.9 5,688 7/6/2021
1.1.8 605 7/6/2021
1.1.4 622 7/6/2021
1.1.3 571 7/6/2021
1.1.1 632 7/6/2021
1.0.5.4 751 7/5/2021
1.0.5.3 595 7/5/2021
1.0.5.2 5,127 3/25/2021
1.0.5.1 5,785 9/5/2020
1.0.5 998 8/30/2020
1.0.4.2 778 8/30/2020
1.0.4.1 801 8/30/2020
1.0.4 831 8/30/2020
1.0.3 809 8/30/2020
1.0.2 839 8/30/2020
1.0.1 731 8/10/2020
1.0.0 810 8/9/2020
1.0.0-beta.4 269 8/9/2020
1.0.0-beta.3 293 8/9/2020
1.0.0-beta.2 318 8/9/2020
1.0.0-beta.1 550 8/9/2020

Inlined the JSON data files into code.