Reference

ASN directory API

Search and list every autonomous system on the internet. No key needed.

List the largest networks

GET/v1/asn/directory

No key needed

Parameters

topintegerquery
How many networks to return, 1 to 1,000.
bystringquery
Rank by addresses or prefixes.

Response fields

totalinteger
Networks in the directory.
countinteger
Results in this response.
results[].asninteger
Autonomous system number.
results[].labelstring
The number written as AS13335.
results[].orgstring
Organisation that runs the network.
results[].networkTypestring
hosting, isp, mobile, vpn or unknown.
results[].ipv4Prefixesinteger
IPv4 prefixes announced.
results[].ipv6Prefixesinteger
IPv6 prefixes announced.
results[].prefixesinteger
All prefixes announced.
results[].addressesinteger
IPv4 addresses the network announces.

curl "https://ipscanner.io/v1/asn/directory?top=2&by=addresses"

Response

{
  "total": 79002,
  "by": "addresses",
  "count": 2,
  "results": [
    {
      "asn": 749,
      "label": "AS749",
      "org": "DNIC-AS-00749",
      "networkType": "unknown",
      "ipv4Prefixes": 2633,
      "ipv6Prefixes": 0,
      "prefixes": 2633,
      "addresses": 224661248
    },
    {
      "asn": 16509,
      "label": "AS16509",
      "org": "AMAZON-02",
      "networkType": "hosting",
      "ipv4Prefixes": 4372,
      "ipv6Prefixes": 1076,
      "prefixes": 5448,
      "addresses": 146593792
    }
  ]
}

Search networks

GET/v1/asn/directory

No key needed

Parameters

qstringqueryRequired
Organisation name or AS number to search for.
limitintegerquery
Most results to return.

Response fields

totalinteger
Networks in the directory.
querystring
The query as the server read it.
countinteger
Results in this response.
resultsarray
Matching networks, same fields as the list.

curl "https://ipscanner.io/v1/asn/directory?q=cloudflare&limit=1"

Response

{
  "total": 79002,
  "query": "cloudflare",
  "count": 1,
  "results": [
    {
      "asn": 13335,
      "label": "AS13335",
      "org": "CLOUDFLARENET",
      "networkType": "hosting",
      "ipv4Prefixes": 426,
      "ipv6Prefixes": 1079,
      "prefixes": 1505,
      "addresses": 1779968
    }
  ]
}

Get one network

GET/v1/asn/directory/{asn}

No key needed

Parameters

asnintegerpathRequired
AS number, with or without the AS prefix.

Response fields

asninteger
Autonomous system number.
labelstring
The number written as AS13335.
orgstring
Organisation that runs the network.
networkTypestring
hosting, isp, mobile, vpn or unknown.
ipv4Prefixesinteger
IPv4 prefixes announced.
ipv6Prefixesinteger
IPv6 prefixes announced.
prefixesinteger
All prefixes announced.
addressesinteger
IPv4 addresses the network announces.
samplePrefixesarray
Largest announced prefixes, with their size.
vpnRangePrefixesinteger
Prefixes that fall in known VPN ranges.
datacenterRangePrefixesinteger
Prefixes that fall in known datacenter ranges.
rangesLoadedboolean
False when range data was not available for this response.

curl https://ipscanner.io/v1/asn/directory/13335

Response

{
  "asn": 13335,
  "label": "AS13335",
  "org": "CLOUDFLARENET",
  "networkType": "hosting",
  "ipv4Prefixes": 426,
  "ipv6Prefixes": 1079,
  "prefixes": 1505,
  "addresses": 1779968,
  "samplePrefixes": [
    {
      "prefix": "104.24.0.0/13",
      "version": 4,
      "addresses": 524288
    },
    {
      "prefix": "104.16.0.0/14",
      "version": 4,
      "addresses": 262144
    }
  ],
  "vpnRangePrefixes": 0,
  "datacenterRangePrefixes": 1,
  "rangesLoaded": true
}