Checkhost

This package is a wrapper for check-host.net, since they don't have an official IP Info API. (and others)

Installation

Use the package manager NPM or yarn to install checkhost.

NPM

npm install checkhost --save

Yarn

yarn add checkhost

Usage

Importing package

Javascript

const checkhost = require("checkhost");

Typescript

import checkhost from "checkhost";

Checking IP

checkhost("1.1.1.1").then(console.log);

Checking from different services

// DB-IP Variants
checkhost("1.1.1.1").then(console.log);
checkhost("1.1.1.1", 0).then(console.log);
checkhost("1.1.1.1", "dbip").then(console.log);
checkhost("1.1.1.1", "db-ip").then(console.log);

// IPGeolocation Variants
checkhost("1.1.1.1").then(console.log);
checkhost("1.1.1.1", 1).then(console.log);
checkhost("1.1.1.1", "ipgeo").then(console.log);
checkhost("1.1.1.1", "ipgeolocation").then(console.log);

// IP2Location Variants
checkhost("1.1.1.1").then(console.log);
checkhost("1.1.1.1", 2).then(console.log);
checkhost("1.1.1.1", "ip2loc").then(console.log);
checkhost("1.1.1.1", "ip2location").then(console.log);

// MaxMind GeoLite2 Variants
checkhost("1.1.1.1").then(console.log);
checkhost("1.1.1.1", 3).then(console.log);
checkhost("1.1.1.1", "geolite2").then(console.log);
checkhost("1.1.1.1", "maxmind-geolite2").then(console.log);

// IP-API Variants
checkhost("1.1.1.1").then(console.log);
checkhost("1.1.1.1", 4).then(console.log);
checkhost("1.1.1.1", "ipapi").then(console.log);
checkhost("1.1.1.1", "ip-api").then(console.log);

// Combined variants
checkhost("1.1.1.1").then(console.log);
checkhost("1.1.1.1", 5).then(console.log);
checkhost("1.1.1.1", "all").then(console.log);
checkhost("1.1.1.1", "combined").then(console.log);

Returns

// DB-IP
{
  ip_address: '1.1.1.1',
  hostname: 'one.one.one.one',
  ip_range: [ '1.1.1.0', '1.1.1.255' ],
  isp: 'Cloudflare, Inc.',
  org: '',
  country: 'Australia',
  country_code: 'AU',
  region: 'New South Wales',
  city: 'Sydney',
  timezone: { region: 'Australia/Sydney', timezone: 'GMT+1000' },
  local_time: { now: '05:27:04 (AEST)', date: '2021.05.03' },
  postal_code: 1001
}

// IPGeolocation
{
  ip_address: '1.1.1.1',
  hostname: 'one.one.one.one',
  ip_range: [ '1.1.1.0', '1.1.1.255' ],
  isp: 'APNIC Research and Development',
  org: 'Cloudflare, Inc.',
  country: 'Australia',
  country_code: 'AU',
  region: 'Queensland',
  city: 'Brisbane',
  timezone: { region: 'Australia/Brisbane', timezone: 'GMT+1000' },
  local_time: { now: '05:27:28 (AEST)', date: '2021.05.03' },
  postal_code: 4101
}

// IP2Location
{
  ip_address: '1.1.1.1',
  hostname: 'one.one.one.one',
  ip_range: [ '1.1.1.0', '1.1.1.255' ],
  isp: '',
  org: '',
  country: 'United States of America',
  country_code: 'US',
  region: 'California',
  city: 'Los Angeles',
  timezone: { region: '-07:00', timezone: undefined },
  local_time: { now: '12:27:40 (-0700)', date: '2021.05.02' },
  postal_code: 90001
}

// MaxMind GeoLite2
{
  ip_address: '1.1.1.1',
  hostname: 'one.one.one.one',
  ip_range: [ '' ],
  isp: '',
  org: '',
  country: 'Australia',
  country_code: 'AU',
  region: '',
  city: '',
  timezone: { region: 'Australia/Sydney', timezone: 'GMT+1000' },
  local_time: { now: '05:27:55 (AEST)', date: '2021.05.03' },
  postal_code: NaN
}

// IP-API
{
  ip_address: '1.1.1.1',
  hostname: '',
  ip_range: ['', ''],
  isp: 'Cloudflare, Inc',
  org: 'APNIC and Cloudflare DNS Resolver project',
  country: 'Australia',
  country_code: 'AU',
  region: 'Queensland',
  city: 'South Brisbane',
  timezone: { region: 'Australia/Brisbane', timezone: '' },
  local_time: { now: '', date: '' },
  postal_code: '4101'
}

// Combined
[
  {
    ip_address: '1.1.1.1',
    hostname: 'one.one.one.one',
    ip_range: [ '1.1.1.0', '1.1.1.255' ],
    isp: 'Cloudflare, Inc.',
    org: '',
    country: 'Australia',
    country_code: 'AU',
    region: 'New South Wales',
    city: 'Sydney',
    timezone: { region: 'Australia/Sydney', timezone: 'GMT+1000' },
    local_time: { now: '05:28:14 (AEST)', date: '2021.05.03' },
    postal_code: 1001
  },
  {
    ip_address: '1.1.1.1',
    hostname: 'one.one.one.one',
    ip_range: [ '1.1.1.0', '1.1.1.255' ],
    isp: 'APNIC Research and Development',
    org: 'Cloudflare, Inc.',
    country: 'Australia',
    country_code: 'AU',
    region: 'Queensland',
    city: 'Brisbane',
    timezone: { region: 'Australia/Brisbane', timezone: 'GMT+1000' },
    local_time: { now: '05:28:14 (AEST)', date: '2021.05.03' },
    postal_code: 4101
  },
  {
    ip_address: '1.1.1.1',
    hostname: 'one.one.one.one',
    ip_range: [ '1.1.1.0', '1.1.1.255' ],
    isp: '',
    org: '',
    country: 'United States of America',
    country_code: 'US',
    region: 'California',
    city: 'Los Angeles',
    timezone: { region: '-07:00', timezone: undefined },
    local_time: { now: '12:28:14 (-0700)', date: '2021.05.02' },
    postal_code: 90001
  },
  {
    ip_address: '1.1.1.1',
    hostname: 'one.one.one.one',
    ip_range: [ '' ],
    isp: '',
    org: '',
    country: 'Australia',
    country_code: 'AU',
    region: '',
    city: '',
    timezone: { region: 'Australia/Sydney', timezone: 'GMT+1000' },
    local_time: { now: '05:28:14 (AEST)', date: '2021.05.03' },
    postal_code: NaN
  },
  {
    ip_address: '1.1.1.1',
    hostname: '',
    ip_range: ['', ''],
    isp: 'Cloudflare, Inc',
    org: 'APNIC and Cloudflare DNS Resolver project',
    country: 'Australia',
    country_code: 'AU',
    region: 'Queensland',
    city: 'South Brisbane',
    timezone: { region: 'Australia/Brisbane', timezone: '' },
    local_time: { now: '', date: '' },
    postal_code: '4101'
  }
]

Example

License

THIS LIBRARY IS NOT IN ANY WAY AFFILIATED WITH check-host.net nor ip-api.com.

Licensed under MIT.