Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ipapi-is/ip_to_asn
Find rich ASN information for each IP address. The output includes IP suffixes, AS type, AS country, AS organisation and so on...
https://github.com/ipapi-is/ip_to_asn
api asn autonomous-system autonomous-systems ip-to-asn
Last synced: 1 day ago
JSON representation
Find rich ASN information for each IP address. The output includes IP suffixes, AS type, AS country, AS organisation and so on...
- Host: GitHub
- URL: https://github.com/ipapi-is/ip_to_asn
- Owner: ipapi-is
- Created: 2022-12-09T14:05:11.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-22T12:12:17.000Z (about 1 year ago)
- Last Synced: 2024-11-09T03:04:50.234Z (6 days ago)
- Topics: api, asn, autonomous-system, autonomous-systems, ip-to-asn
- Language: JavaScript
- Homepage: https://ipapi.is/
- Size: 6.84 KB
- Stars: 11
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# IP to ASN
[](https://www.npmjs.com/package/asn-from-ip)
[](https://npmjs.com/package/asn-from-ip)
This tiny package allows you to obtain ASN meta information for any IP address. Some IP addresses are of course not assigned to an ASN.
## Installation
```bash
npm install asn-from-ip
```
If you want to clone the repository directly from GitHub instead:
```bash
git clone [email protected]:ipapi-is/ip_to_asn.git
```
## Usage from Node.js
Lookup the IP address `95.91.211.148`:
```JavaScript
const { ipToASN } = require('asn-from-ip');
(async () => {
console.log(await ipToASN('95.91.211.148'));
})();
```
which outputs (at the time of writing):
```JavaScript
{
asn: 3209,
route: '95.88.0.0/14',
descr: 'VODANET International IP-Backbone of Vodafone, DE',
country: 'de',
active: true,
org: 'Vodafone GmbH',
domain: 'vodafone.com',
abuse: '[email protected]',
type: 'isp',
created: '2002-09-11',
updated: '2023-10-12',
rir: 'ripe',
whois: 'https://api.ipapi.is/?whois=AS3209'
}
```
Most IP addresses can be associated with an Autonomeous System (AS). The return value of `ipToASN()` is an object with the following attributes:
- `asn` - `int` - The AS number
- `route` - `string` - The IP route as CIDR in this AS
- `descr` - `string` - An informational description of the AS
- `country` - `string` - The country where the AS is situated in (administratively)
- `active` - `string` - Whether the AS is active (active = at least one route administred by the AS)
- `domain` - `string` - The domain of the organization to which this AS belongs
- `org` - `string` - The organization responisible for this AS
- `type` - `string` - The type for this ASN, this is either `hosting`, `education`, `goverment`, `banking`, `business` or `isp`
- `created` - `string` - When the ASN was established
- `updated` - `string` - The last time the ASN was updated
- `rir` - `string` - To which Regional Internet Registry the ASN belongs
- `whois` - `string` - An url to the whois information for this ASN
For inactive autonomeous systems, most of the above information is not available.
## Usage from the Browser
Copy the browser JavaScript bundle to your preferred location. After installing the module with
```bash
npm install asn-from-ip
```
you can find the minified JavaScript here: `node_modules/asn-from-ip/dist/ipToASN.min.js`
```html
IP to ASN Example Browser
ipToASN('95.91.211.148').then((res) => {
document.getElementById('asn').innerText = JSON.stringify(res, null, 2);
});
```
## Use the Database Directly
This package uses the [ipapi.is API](https://ipapi.is/developers.html) in order to avoid shipping a huge database in the npm module. If you have a large volume of IP addresses to lookup, you can download the full & free [ASN Database](https://ipapi.is/asn.html).
GitHub mirror of the database: [ASN Database Mirror](https://github.com/ipapi-is/ipapi/tree/main/databases)