Added support for AS domain, AS usage type and AS CIDR

ip2location · ip2location · commit fcc23f469e65 · 2025-09-03T09:47:46.000+08:00
diff --git a/LICENSE b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 - 2024 IP2Location.com
+Copyright (c) 2023 - 2025 IP2Location.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/README.md b/README.md
@@ -1,28 +1,24 @@
-[![npm](https://img.shields.io/npm/v/ip2location-nodejs.svg)](http://npm.im/ip2location-nodejs)
-[![npm](https://img.shields.io/npm/dm/ip2location-nodejs.svg)](http://npm.im/ip2location-nodejs)
-
-# IP2Location Node.js Module
-
-This Node.js module provides a fast lookup of country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type, IAB category, district, autonomous system number (ASN) and autonomous system (AS) from IP address by using IP2Location database. This module uses a file based database available at IP2Location.com. This database simply contains IP blocks as keys, and other information such as country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type, IAB category, district, autonomous system number (ASN) and autonomous system (AS) as values. It supports both IP address in IPv4 and IPv6.
-
-This module can be used in many types of projects such as:
-
- - select the geographically closest mirror
- - analyze your web server logs to determine the countries of your visitors
- - credit card fraud detection
- - software export controls
- - display native language and currency 
- - prevent password sharing and abuse of service 
- - geotargeting in advertisement
-
-The database will be updated on a monthly basis for greater accuracy.
-
-The complete database is available at https://www.ip2location.com under Premium subscription package.
-The free LITE database is available at https://lite.ip2location.com.
-
-As an alternative, this module can also call the IP2Location Web Service. This requires an API key. If you don't have an existing API key, you can subscribe for one at the below:
-
-https://www.ip2location.com/web-service/ip2location
-
-## Developer Documentation
-To learn more about installation, usage, and code examples, please visit the developer documentation at [https://ip2location-nodejs.readthedocs.io/en/latest/index.html.](https://ip2location-nodejs.readthedocs.io/en/latest/index.html)
+[![npm](https://img.shields.io/npm/v/ip2location-nodejs.svg)](http://npm.im/ip2location-nodejs)
+[![npm](https://img.shields.io/npm/dm/ip2location-nodejs.svg)](http://npm.im/ip2location-nodejs)
+
+# IP2Location Node.js Module
+
+This Node.js module provides a fast lookup of country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type, IAB category, district, autonomous system number (ASN) and autonomous system (AS) from IP address by using IP2Location database. This module uses a file based database available at IP2Location.com. This database simply contains IP blocks as keys, and other information such as country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type, IAB category, district, autonomous system number (ASN), autonomous system (AS), AS domain, AS usage type and AS CIDR as values. It supports both IP address in IPv4 and IPv6.
+
+This module can be used in many types of projects such as:
+
+ - select the geographically closest mirror
+ - analyze your web server logs to determine the countries of your visitors
+ - credit card fraud detection
+ - software export controls
+ - display native language and currency 
+ - prevent password sharing and abuse of service 
+ - geotargeting in advertisement
+
+The database will be updated on a monthly basis for greater accuracy.
+
+The complete database is available at https://www.ip2location.com under Premium subscription package.
+The free LITE database is available at https://lite.ip2location.com.
+
+## Developer Documentation
+To learn more about installation, usage, and code examples, please visit the developer documentation at [https://ip2location-nodejs.readthedocs.io/en/latest/index.html.](https://ip2location-nodejs.readthedocs.io/en/latest/index.html)
diff --git a/docs/source/code.md b/docs/source/code.md
@@ -54,6 +54,9 @@ Retrieve geolocation information for an IP address.
 | district         |     District or county name. |
 | asn              |     Autonomous system number (ASN). BIN databases. |
 | as          |     Autonomous system (AS) name. |
+| asDomain    | Domain name of the AS registrant. |
+| asUsageType    | Usage type of the AS registrant. |
+| asCidr    | CIDR range for the whole AS. |
 ```
 
 ```{py:function} getAllAsync(ipAddress)
@@ -92,6 +95,9 @@ Retrieve geolocation information for an IP address asynchronously.
 | district         |     District or county name. |
 | asn              |     Autonomous system number (ASN). BIN databases. |
 | as          |     Autonomous system (AS) name. |
+| asDomain    | Domain name of the AS registrant. |
+| asUsageType    | Usage type of the AS registrant. |
+| asCidr    | CIDR range for the whole AS. |
 ```
 
 ## IPTools Class
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -6,11 +6,11 @@
 # -- Project information
 
 project = 'IP2Location Node.js'
-copyright = '2023, IP2Location'
+copyright = '2025, IP2Location'
 author = 'IP2Location'
 
-release = '1.0.0'
-version = '1.0.0'
+release = '9.7.0'
+version = '9.7.0'
 
 # -- General configuration
 
diff --git a/docs/source/index.md b/docs/source/index.md
@@ -2,7 +2,7 @@
 [![npm](https://img.shields.io/npm/dm/ip2location-nodejs.svg)](http://npm.im/ip2location-nodejs)
 # IP2Location Node.js Library
 
-This Node.js module provides a fast lookup of country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type, IAB category, district, autonomous system number (ASN) and autonomous system (AS) from IP address by using IP2Location database. This module uses a file based database available at IP2Location.com. This database simply contains IP blocks as keys, and other information such as country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type, IAB category, district, autonomous system number (ASN) and autonomous system (AS) as values. It supports both IP address in IPv4 and IPv6.
+This Node.js module provides a fast lookup of country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type, IAB category, district, autonomous system number (ASN) and autonomous system (AS) from IP address by using IP2Location database. This module uses a file based database available at IP2Location.com. This database simply contains IP blocks as keys, and other information such as country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type, IAB category, district, autonomous system number (ASN), autonomous system (AS), AS domain, AS usage type and AS CIDR as values. It supports both IP address in IPv4 and IPv6.
 
 This module can be used in many types of projects such as:
 
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
 	"name": "ip2location-nodejs",
-	"version": "9.6.3",
+	"version": "9.7.0",
 	"description": "IP2Location geolocation component",
 	"keywords": [
 		"ip2location",
diff --git a/src/ip2location.d.ts b/src/ip2location.d.ts
@@ -199,6 +199,9 @@ export class IP2Location {
         district: string;
         asn: string;
         as: string;
+        asDomain: string;
+        asUsageType: string;
+        asCidr: string;
     };
     /**
      * Performs validations and returns geolocation data asynchronously.
@@ -235,6 +238,9 @@ export class IP2Location {
         district: string;
         asn: string;
         as: string;
+        asDomain: string;
+        asUsageType: string;
+        asCidr: string;
     }>;
     /**
      * Returns the API version.
@@ -604,6 +610,48 @@ export class IP2Location {
      * @returns The promise of the AS.
      */
     getASAsync(myIP: string): Promise<string>;
+    /**
+     * Returns the AS domain.
+     *
+     * @param myIP The IP address to query.
+     * @returns The AS domain.
+     */
+    getASDomain(myIP: string): string;
+    /**
+     * Returns the AS domain asynchronously.
+     *
+     * @param myIP The IP address to query.
+     * @returns The promise of the AS domain.
+     */
+    getASDomainAsync(myIP: string): Promise<string>;
+    /**
+     * Returns the AS usage type.
+     *
+     * @param myIP The IP address to query.
+     * @returns The AS usage type.
+     */
+    getASUsageType(myIP: string): string;
+    /**
+     * Returns the AS usage type asynchronously.
+     *
+     * @param myIP The IP address to query.
+     * @returns The promise of the AS usage type.
+     */
+    getASUsageTypeAsync(myIP: string): Promise<string>;
+    /**
+     * Returns the AS CIDR.
+     *
+     * @param myIP The IP address to query.
+     * @returns The AS CIDR.
+     */
+    getASCidr(myIP: string): string;
+    /**
+     * Returns the AS CIDR asynchronously.
+     *
+     * @param myIP The IP address to query.
+     * @returns The promise of the AS CIDR.
+     */
+    getASCidrAsync(myIP: string): Promise<string>;
     /**
      * Returns all fields.
      *
@@ -638,6 +686,9 @@ export class IP2Location {
         district: string;
         asn: string;
         as: string;
+        asDomain: string;
+        asUsageType: string;
+        asCidr: string;
     };
     /**
      * Returns all fields asynchronously.
@@ -673,6 +724,9 @@ export class IP2Location {
         district: string;
         asn: string;
         as: string;
+        asDomain: string;
+        asUsageType: string;
+        asCidr: string;
     }>;
     #private;
 }
diff --git a/src/ip2location.js b/src/ip2location.js
diff --git a/src/test.js b/src/test.js

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "ip2location-nodejs",`
`3`		`- "version": "9.6.3",`
	`3`	`+ "version": "9.7.0",`
`4`	`4`	`"description": "IP2Location geolocation component",`
`5`	`5`	`"keywords": [`
`6`	`6`	`"ip2location",`