New Case Study:See how Anthropic automated 95% of dependency reviews with Socket.Learn More
Socket
Sign inDemoInstall
Socket

ip-info-finder

Package Overview
Dependencies
Maintainers
1
Versions
36
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

ip-info-finder

A package for analyzing IP addresses and retrieving valuable information, such as physical address, country of registration, WHOIS data, and weather information.

  • 3.0.3
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
682
increased by47.62%
Maintainers
1
Weekly downloads
 
Created
Source

ip-info-finder

npm building workflow Github All Releases GitHub issues License: MIT

alt text

This package provides additional information on an IP address, such as its whois information, country, city, mobile status, user proxy or VPN status, and more. It supports both IPv4 and IPv6.
The package allows you to retrieve the following data:

  • Location (street, county, etc.)
  • Weather
  • Currency rates
  • Whois information
  • COVID-19 statistics

Installation

Install via NPM:

npm install ip-info-finder

Usage

javascript
var ipInfo = require("ip-info-finder");

ipInfo.getIPInfo('IP-ADDRESS').then(data => {
    console.log(data);
})
.catch(err => console.log(err));
TypeScript
import * as ipInfo from 'ip-info-finder';

ipInfo.getIPInfo('IP-ADDRESS').then(data => {
    console.log(data);
})
.catch(err => console.log(err));
Result
{
  "Country": "United States (US)",
  "Continent": "North America (NA)",
  "Coordinates": "37.751 (lat) / -97.822 (long)",
  "Time": "2023-03-08 11:45:18 (America/Chicago)",
  "ipAddress": "28.106.238.158",
  "hostname": "28.106.238.158",
  "provider": "DNIC-AS-00749",
  "ASN": "749",
  "lat": "37.751",
  "lon": "-97.822",
  "CountryInfo": {
    "name": "United States",
    "dial_code": "+1",
    "emoji": "🇺🇸",
    "code": "US",
    "population": 326687501
  }
}

If you are experiencing a CORS issue or require additional data, you will need to set the CORS value to 'false' as shown in the following code:

ipInfo.getIPInfo('28.106.238.158', options = { cors: false }).then(data => {
    console.log(data);
}).catch(err => console.log(err));

Optional setting

Location

discover detail of the area from ip like county , city , street , suburb , postcode and so on.

ipInfo.getIPInfo.location('IP-ADDRESS').then(data => {
    console.log(data);
})
.catch(err => console.log(err));
Result
{
  "Country": "United States (US)",
  "Continent": "North America (NA)",
  "Coordinates": "37.751 (lat) / -97.822 (long)",
  "Time": "2022-12-15 05:59:09 (America/Chicago)",
  "ipAddress": "28.106.238.158",
  "hostname": "28.106.238.158",
  "provider": "DNIC-AS-00749",
  "ASN": "749",
  "lat": "37.751",
  "lon": "-97.822",
  "location": [
    {
      "place_id": 297371111,
      "licence": "Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type": "relation",
      "osm_id": 1070327,
      "boundingbox": [ "37.733658", "38.1738097", "-98.473104", "-97.698692" ],
      "lat": "37.930344",
      "lon": "-98.1055753",
      "display_name": "Reno County, Kansas, United States",
      "class": "boundary",
      "type": "administrative",
      "importance": 0.001,
      "icon": "https://nominatim.openstreetmap.org/ui/mapicons/poi_boundary_administrative.p.20.png",
      "address": {
        "county": "Reno County",
        "state": "Kansas",
        "ISO3166-2-lvl4": "US-KS",
        "country": "United States",
        "country_code": "us"
      }
    }
  ]
}

WHOIS

find whois easily by ip or website address.

ipInfo.getIPInfo.whois('IP OR WEBSITE').then(data => {
    console.log(data);
})
.catch(err => console.log(err));

Result
{
  "DomainName": "github.com",
  "RegistryDomainID": "1264983250_DOMAIN_COM-VRSN",
  "RegistrarWHOISServer": "whois.markmonitor.com",
  "RegistrarURL": "http",
  "UpdatedDate": "2022-09-07T09",
  "CreationDate": "2007-10-09T18",
  "RegistrarRegistrationExpirationDate": "2024-10-09T00",
  "RegistrarIANAID": "292",
  "RegistrarAbuseContactPhone": "+1.2086851750",
  "DomainStatus": "clientDeleteProhibited (https",
  "RegistrantOrganization": "GitHub, Inc.",
  "RegistrantStateProvince": "CA",
  "RegistrantCountry": "US",
  "RegistrantEmail": "Select Request Email Form at https",
  "AdminOrganization": "GitHub, Inc.",
  "AdminStateProvince": "CA",
  "AdminCountry": "US",
  "AdminEmail": "Select Request Email Form at https",
  "TechOrganization": "GitHub, Inc.",
  "TechStateProvince": "CA",
  "TechCountry": "US",
  "TechEmail": "Select Request Email Form at https",
  "NameServer": "dns2.p08.nsone.net",
  "URLoftheICANNWHOISDataProblemReportingSystem": "http",
  "LastupdateofWHOISdatabase": "2022-12-15T12",
  "VisitMarkMonitorathttps": "//www.markmonitor.com",
  "InformationUpdated": "2022-12-15 12"
}

IP checker

var ipInfo = require("ip-info-finder")


await ipInfo.getIPInfo.isIP('1:2:3:4:5:6:7:8');
//=> true
await ipInfo.getIPInfo.isIP('192.168.0.1');
//=> true
await ipInfo.getIPInfo.isIPv4('1:2:3:4:5:6:7:8');
//=> false
await ipInfo.getIPInfo.isIPv6('1:2:3:4:5:6:7:8');
//=> true
await ipInfo.getIPInfo.ipVersion('1:2:3:4:5:6:7:8');
//=> 6

Weather

what's more you can discover climate from IP address

ipInfo.getIPInfo.weather('IP-ADDRESS').then(data => {
    console.log(data);
})
.catch(err => console.log(err));
Result
{
  "Country": "France (FR)",
  "Continent": "Europe (EU)",
  "Coordinates": "48.8582 (lat) / 2.3387 (long)",
  "Time": "2023-01-20 19:18:24 (Europe/Paris)",
  "ipAddress": "51.15.80.14",
  "hostname": "14-80-15-51.instances.scw.cloud",
  "provider": "Online S.a.s.",
  "ASN": "12876",
  "lat": "48.8582",
  "lon": "2.3387",
  "weather": {
    "location": "Paris",
    "locationDetail": "Île-de-France, France",
    "currentWeather": {
      "temperature": "4°C",
      "dewPoint": "1°C",
      "barometer": "102 kPa",
      "wind": "W 11 km/h",
      "humidity": "80.8 %",
      "visibility": "n/a",
      "time": "Updated Jan 20, 2023 6:30 PM"
    },
    "forecastSummary": [
      {
        "day": "Today",
        "date": "Jan 20th",
        "result": "Cloudy",
        "min": "5°C"
      },
      {
        "day": "Saturday",
        "date": "Jan 21st",
        "result": "Sunny",
        "min": "4°C",
        "max": "0°C"
      },
      {
        "day": "Sunday",
        "date": "Jan 22nd",
        "result": "Mostly Sunny",
        "min": "4°C",
        "max": "-1°C"
      },
      {
        "day": "Monday",
        "date": "Jan 23rd",
        "result": "Mix of Cloud and Sun",
        "min": "3°C",
        "max": "-0°C"
      },
      {
        "day": "Tuesday",
        "date": "Jan 24th",
        "result": "Sunny",
        "min": "4°C",
        "max": "-1°C"
      }
    ],
    "forecastDetails": [
      {
        "date": "Friday, January 20th, 2023",
        "results": [
          {
            "time": "Friday Evening",
            "forecast": "Cloudy.",
            "temperature": "3°C"
          }
        ]
      },
      {
        "date": "Saturday, January 21st, 2023",
        "results": [
          {
            "time": "Overnight",
            "forecast": "Cloudy with clear periods. Windy at times.",
          },
          {
            "time": "Saturday Morning",
            "forecast": "Sunny with cloudy periods. Windy at times.",
            "temperature": "0°C"
          },
          {
            "time": "Saturday Afternoon",
            "forecast": "Sunny. Windy at times.",
            "temperature": "4°C"
          },
          {
            "time": "Saturday Evening",
            "forecast": "Clear. Windy at times.",
            "temperature": "0°C"
          }
        ]
      }
    ]
  }
}

Currency

access latest currency rate from IP this method give you lists of all the available currencies in prettified json format:

ipInfo.getIPInfo.currency('IP-ADDRESS').then(data => {
    console.log(data);
})
.catch(err => console.log(err));
Result
{
  "as": "AS14061 DigitalOcean, LLC",
  "asname": "DIGITALOCEAN-ASN",
  "city": "North Bergen",
  "continent": "North America",
  "continentCode": "NA",
  "country": "United States",
  "countryCode": "US",
  "currency": "USD",
  "district": "",
  "hosting": true,
  "isp": "DigitalOcean, LLC",
  "lat": 40.793,
  "lon": -74.0247,
  "mobile": false,
  "offset": -14400,
  "org": "Digital Ocean",
  "proxy": false,
  "query": "2604:a880:400:d0::1ec5:f001",
  "region": "NJ",
  "regionName": "New Jersey",
  "status": "success",
  "timezone": "America/New_York",
  "zip": "07047",
  "currencyDetail": {
    "date": "2021-08-30",
    "usd": {
      "aed": 3.67301,
      "afn": 86.12501,
      "all": 103.6936,
      "amd": 493.71,
      "ang": 1.794866,
    }
  }
}

Covid statistics

access most recent Coronavirus statistics from IP.

ipInfo.getIPInfo.covid('IP-ADDRESS').then(data => {
  console.log(data);
})
.catch(err => console.log(err));
Result
"covid": {
    "country": "USA",
    "cases": 40131681,
    "todayCases": 17582,
    "deaths": 658103,
    "todayDeaths": 193,
    "recovered": 31023726,
    "active": 8449852,
    "critical": 25691,
    "casesPerOneMillion": 120421,
    "deathsPerOneMillion": 1975,
    "totalTests": 584387097,
    "testsPerOneMillion": 1753534
  }

Languages

get result with your language

Example
//Arabic 
ipInfo.getIPInfo('IP-ADDRESS',options: {lang: 'ar'}).then(data => {
    console.log(data);
})
.catch(err => console.log(err));

//French 
ipInfo.getIPInfo('IP-ADDRESS',options: {lang: 'fr'}).then(data => {
    console.log(data);
})
.catch(err => console.log(err));
Result
{
  "City": "Europe (UE)",
  "Region": "Angleterre (ENG)",
  "Country": "Royaume-Uni (GB)",
  "Continent": "Londres",
  "Coordinates": "51.5164 (lat) / -0.093 (long)",
  "Time": "2022-08-05 21:35:14 (Europe/London)",
  "ipAddress": "212.102.63.76",
  "hostname": "unn-212-102-63-76.cdn77.com",
  "provider": "Datacamp Limited",
  "ASN": "60068",
  "lat": "51.5164",
  "lon": "-0.093",
  "postalCode": "EC2V"
}

Support

Contributors

Pull requests are always welcome! Please base pull requests against the main branch and follow the contributing guide.

if your pull requests makes documentation changes, please update readme file.

License

This project is licensed under the terms of the MIT license

FOSSA Status

Keywords

FAQs

Package last updated on 29 Jun 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc