ASN rank list

Introduction

The Autonomous System (AS) rank list API is a flexible API that provides a comprehensive and up-to-date list of AS numbers, sorted by rank, ASN number, organisation, and country code. The ASN is ranked based on the total number of IPv4 addresses announced by the network.

This information is of great value to network administrators, security analysts, and business decision-makers who require a thorough understanding of the network landscape and data-driven insights to guide their decision-making.

These capabilities can lead to better network performance, lower costs and improved overall security. Moreover, the ASN rank list API can be integrated with other systems and tools to provide a more comprehensive view of network operations and performance.

Get Started

This API is part of the Network Engineering API Package and is available in free and paid plans. Please visit the Network Engineering API Package package page for limits and pricing information.

Endpoints

IPv4 only API Endpoint

Use this endpoint to force API calls routed over the IPv4 network only

GET

https://api.bigdatacloud.net/data/asn-rank-list

Dual-Stack API Endpoint

This endpoint has native IPv6 support and backs the API calls routed over both IPv4 and IPv6 networks

GET

https://api-bdc.net/data/asn-rank-list

Request

Parameter

Type

Required

Description

batchSize

integer (int32)

Optional, default value: 10

Requested batch size. Maximum value = 1000

offset

integer (int32)

Optional, default value: 0

Offset. Number of entries to skip

sort

string, enum (rank, asn, asnNumeric, organisation, countryCode)

Optional, default value: rank

Sort response by a field value. Default value: rank

order

string, enum (asc, desc)

Optional, default value: asc

Sort order. Default value: asc

localityLanguage

string

Optional, default value: en

Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. If the requested language is not available for a requested location, it will default to English. If no English variant is known, will provide the native, local names

key

string

Yes

Your API key

Responses

200

Success

Sample Query

GET

https://api-bdc.net/data/asn-rank-list?batchSize=10&offset=0&sort=rank&order=asc&localityLanguage=en&key=[YOUR API KEY]

Schema

application/json

totalinteger

Total number of entries available

offsetinteger

Number of entries to skipped

batchinteger

Number of entries in the current batch

asnsarray

Array of ASN entries returned

asnstring

Autonomous System Number string

asnNumericinteger

Autonomous System Number

organisationstring

Registered Organisation

namestring

Registered name

registrystring

The Regional Internet Registry (RIR) the AS is registered with

registeredCountrystring

Registered Country ISO 3166-1 Alpha-2 code

registeredCountryNamestring

Registered Country localised name. The language is as defined by the 'localityLanguage' request parameter

totalIpv4Addressesinteger

Total number of IP addresses announced by the AS

rankinteger

Global rank by total number of IP addresses announced

rankTextstring

Global rank by total number of IP addresses announced including total

Sample Response

400

Bad request

Sample Response

403

Access denied, or your quota limit has exceeded

Sample Response

406

Found too many result items. Please reduce the scope of your request

Sample Response

500

An error has occurred and did not complete your request. Please try again

Sample Response

Was this page helpful?