ASN rank list
This API returns a ranked list of Autonomous Systems, sortable by rank, ASN number, organisation name, or country code. ASNs are ranked by the total number of IPv4 addresses they announce on BGP — a useful proxy for the relative size and reach of a network.
It's useful for network research, competitive analysis, and building tooling that needs a current, sortable view of the global AS landscape. The list is paginated via batchSize and offset parameters.
GET
https://api-bdc.net/data/asn-rank-listParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
batchSize | integer (int32) | Optional | Requested batch size. Maximum value = 1000 |
offset | integer (int32) | Optional | Offset. Number of entries to skip |
sort | string, enum (rank, asn, asnNumeric, organisation, countryCode) | Optional | Sort response by a field value. Default value: rank |
order | string, enum (asc, desc) | Optional | Sort order. Default value: asc |
localityLanguage | string | Optional | 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 | Optional | Your API key |
Responses
200OK
Sample Request
https://api-bdc.net/data/asn-rank-list?batchSize=10&offset=0&sort=rank&order=asc&localityLanguage=en&key=[YOUR API KEY]Sample Response
JSON View
Response Schema
totalintegerTotal number of entries available
offsetintegerNumber of entries skipped (pagination offset)
batchintegerNumber of entries in the current batch
▶asnsarrayArray of ASN entries returned
asnstringThe Autonomous System Number in prefixed string format (e.g. "AS13335").
asnNumericintegerThe Autonomous System Number as an unsigned integer (e.g. 13335).
organisationstringThe organisation or entity the AS is registered for, as recorded in the RIR database.
namestringThe short handle or network name assigned to the AS by the RIR (e.g. "CLOUDFLARENET").
registrystringThe Regional Internet Registry (RIR) the AS is registered with
registeredCountrystringRegistered Country ISO 3166-1 Alpha-2 code
registeredCountryNamestringRegistered Country localised name. The language is as defined by the 'localityLanguage' request parameter
totalIpv4AddressesintegerTotal number of IP addresses announced by the AS
rankintegerGlobal rank by total number of IP addresses announced
rankTextstringHuman-readable global rank string including the total number of ranked ASNs (e.g. "#297 out of 79,835").
400Bad request
Sample Response
JSON View
403Access denied, or your quota limit has exceeded
Sample Response
JSON View
406Found too many result items. Please reduce the scope of your request
Sample Response
JSON View
500An error has occurred and did not complete your request. Please try again
Sample Response
JSON View