API Documentation

This page contains documentation and examples showing how to access and use our API.
All API calls require a valid API key. To obtain an API key, check out our API plans.
To try out the API first, create an account and get a free API key.



Endpoints

The following table lists the available APIs and the plans they are available to. Free keys can call every API.

- Organisation SearchAll plans
- Organisation InfoAll plans
- Organisation NetworksProfessional, Business
- IP Address InfoAll plans
- IP GeolocationAll plans except Basic
- Domains on IP (Reverse DNS)Professional, Business
- Domains in Network (Mass Reverse DNS)Business
- Autonomous System InfoAll plans
- Autonomous System NetworksAll plans except Basic



Output formats

The API support JSON and XML outputs.
The default is JSON. To switch to XML, add the parameter "format=xml" to any request (GET or POST).



Parameters

For convenience, any required or non-required parameter can be sent through GET or POST. For example, testing the API through a web browser may be easier by sending the paramters through the URL. The API key can be specified via the "X-Api-Key" HTTP header, or through the "apikey" GET or POST paramter.
The following examples are equivalent:

$ curl -s -H "X-Api-Key: sample_api_key" "https://networksdb.io/api/org/search" -d search=Google

$ curl -s "https://networksdb.io/api/org/search?apikey=sample_api_key&search=Google"

$ curl -s "https://networksdb.io/api/org/search" -d apikey=sample_api_key -d search=Google

$ curl -s "https://networksdb.io/api/org/search?apikey=sample_api_key" -d search=Google



Pagination

For queries returning a large number of results, 1000 results will be returned per page.
The first page has number 1 (default value). To get the next page of results, include the parameter "page=X" in your request. For example, to get results 1001 to 2000, include "page=2".



Organisation Search

DescriptionSearch for organisations matching a search term.
OutputA list of organisations.
Endpointhttps://networksdb.io/api/org/search
MethodsGET, POST
Required parameterssearch [your search query]
Optional parameterscountry [to search this country only]
page [page number]
Example request$ curl -sH "X-Api-Key: sample_api_key" https://networksdb.io/api/org/search -d search=Google -d country=US { "total": 449, "page": 1, "results": [ { "organisation": "Google LLC", "id": "google-llc", "address": null, "country": "United States", "countrycode": "US", "other_countries": [], "networks": 243, "addresses": 6349234, "url": "https://networksdb.io/ip-addresses-of/google-llc", "asns": [ "15169", "16550", "22577", "22859", "26684", "36039", "36040", "36384", "36385", "36492", "40873", "394507", "394639", "395973", "396982" ] }, { "organisation": "Google Fiber Inc.", "id": "google-fiber-inc", "address": null, "country": "United States", "countrycode": "US", "other_countries": [], "networks": 19, "addresses": 2244672, "url": "https://networksdb.io/ip-addresses-of/google-fiber-inc", "asns": [ "6432", "16591", "19448" ] }, // truncated... } }



Organisation Info

DescriptionRetreive information about an organisation.
OutputInformation about the organisation requested.
Endpointhttps://networksdb.io/api/org/info
MethodsGET, POST
Required parametersid [organisation ID returned by the search query]
Optional parametersN/A
Example request$ curl -sH "X-Api-Key: sample_api_key" https://networksdb.io/api/org/info -d id=google-llc { "total": 1, "page": 1, "results": [ { "organisation": "Google LLC", "id": "google-llc", "address": null, "country": "United States", "countrycode": "US", "networks_by_country": [ { "code": "US", "name": "United States", "nb_nets": 243 } ], "networks": 243, "addresses": 6349234, "url": "https://networksdb.io/ip-addresses-of/google-llc", "asns": [ 15169, 16550, 22577, 22859, 26684, 36039, 36040, 36384, 36385, 36492, 40873, 394639, 395973, 396982, 394507 ] } ] }



Organisation Networks

DescriptionSearch for the public networks owned by an organisation.
OutputA list public networks.
Endpointhttps://networksdb.io/api/org/networks
MethodsGET, POST
Required parametersid [organisation ID returned by the search query]
Optional parameterspage [page number]
Example request$ curl -sH "X-Api-Key: sample_api_key" https://networksdb.io/api/org/networks -d id=google-llc { "total": 243, "page": 1, "results": [ { "netname": "GOOGLE-CLOUD", "description": "Google LLC", "extrainfo": "GOOGLE-CLOUD", "countrycode": "US", "country": "United States", "addresses": 2621440, "cidr": null, "first_ip": "35.208.0.0", "last_ip": "35.247.255.255" }, { "netname": "GOOGL-46", "description": "Google LLC", "extrainfo": "GOOGL-46", "countrycode": "US", "country": "United States", "addresses": 1048576, "cidr": "136.112.0.0/12", "first_ip": "136.112.0.0", "last_ip": "136.127.255.255" }, { "netname": "GOOGLE-CLOUD", "description": "Google LLC", "extrainfo": "GOOGLE-CLOUD", "countrycode": "US", "country": "United States", "addresses": 1048576, "cidr": "35.192.0.0/12", "first_ip": "35.192.0.0", "last_ip": "35.207.255.255" },



IP Address Info

DescriptionSearch for an IPv4 address.
OutputInformation about the IP address, its owner company, network, and geolocation
Endpointhttps://networksdb.io/api/ip/info
MethodsGET, POST
Required parametersip [the IP address to look up]
Optional parametersN/A
Example request$ curl -sH "X-Api-Key: sample_api_key" https://networksdb.io/api/ip/info -d ip=8.8.8.8 { "total": 1, "page": 1, "results": [ { "ip": "8.8.8.8", "domains_on_ip": 7337, "url": "https://networksdb.io/ip/8.8.8.8", "organisation": { "name": "Google LLC", "id": "google-llc", "description": "Google LLC", "url": "https://networksdb.io/ip-addresses-of/google-llc" }, "network": { "netname": "LVLT-GOGL-8-8-8", "cidr": "8.8.8.0/24", "first_ip": "8.8.8.0", "last_ip": "8.8.8.255", "url": "https://networksdb.io/ips-in-network/8.8.8.0/8.8.8.255" } } ] }



IP Geolocation

DescriptionRequest geolocation information for a given IP Address.
OutputGeolocation information including city, state, country, latitude and longitude.
Endpointhttps://networksdb.io/api/ip/geo
MethodsGET, POST
Required parametersip [the IP address to look up]
Optional parametersN/A
Example request$ curl -sH "X-Api-Key: sample_api_key" https://networksdb.io/api/ip/geo -d ip=8.8.8.8 { "total": 1, "page": 1, "results": [ { "ip": "8.8.8.8", "continent": "North America", "countrycode": "US", "country": "United States", "state": "California", "city": "Mountain View", "latitude": 37.406, "longitude": -122.079 } ] }



Domains on IP (Reverse DNS)

DescriptionPerform a reverse DNS lookup to find all the domain names pointing to the given IPv4 address.
OutputA list of domain names.
Endpointhttps://networksdb.io/api/ip/domains
MethodsGET, POST
Required parametersip [the IP address to look up]
Optional parameterspage [page number]
Example request$ curl -sH "X-Api-Key: sample_api_key" https://networksdb.io/api/ip/domains -d ip=93.184.216.34 { "total": 45, "page": 1, "results": [ // truncated... "example.com", "example.edu", "example.net", "example.org", // truncated... ] }



Domains in Network (Mass Reverse DNS)

DescriptionPerform a "mass" reverse DNS lookup to find all the domain names pointing to any IPv4 address in the given network.
OutputA list of IP addresses with the attached domain names.
Endpointhttps://networksdb.io/api/network/domains
MethodsGET, POST
Required parametersip_start [the network's first IP]
ip_end [the network's last IP]
Optional parameterspage [page number]
Example request$ curl -sH "X-Api-Key: sample_api_key" https://networksdb.io/api/network/domains -d ip_start=93.184.216.0 -d ip_end=93.184.216.255 { "total": 270, "page": 1, "results": [ { "ip": "93.184.216.11", "domains": [ "sexdwarf.org", "wicklow.org" ] }, { "ip": "93.184.216.34", "domains": [ // truncated ... "example.com", "example.edu", "example.net", "example.org", // truncated ... ] }, { "ip": "93.184.216.38", "domains": [ "ignitecampaigns.com", "job-applications.com", "vz-sinclairstoryline.com" ] }, // truncated ... ] }



Autonomous System Info

DescriptionSearch for an autonomous system.
OutputInformation about the autonomous sytem, its owner company and the number of networks and addresses it announces.
Endpointhttps://networksdb.io/api/as/info
MethodsGET, POST
Required parametersasn [the autonomous system number]
Optional parametersN/A
Example request$ curl -sH "X-Api-Key: sample_api_key" https://networksdb.io/api/as/info -d asn=15169 { "total": 1, "page": 1, "results": [ { "asn": 15169, "as_name": "GOOGLE", "description": "Google LLC", "networks_announced": 440, "addresses_announced": "10372096", "countrycode": "US", "country": "United States", "url": "https://networksdb.io/autonomous-system/AS15169", "organisation": { "name": "Google LLC", "id": "google-llc", "url": "https://networksdb.io/ip-addresses-of/google-llc" } } ] }



Autonomous System Networks

DescriptionSearch for the networks announced by an autonomous system.
OutputA list of networks.
Endpointhttps://networksdb.io/api/as/networks
MethodsGET, POST
Required parametersasn [the autonomous system number]
Optional parameterspage [page number]
Example request$ curl -sH "X-Api-Key: sample_api_key" https://networksdb.io/api/as/networks -d asn=15169 { "total": 384, "page": 1, "results": [ { "cidr": "89.207.231.0/24", "first_ip": "89.207.231.0", "last_ip": "89.207.231.255", "countrycode": "CH", "country": "Switzerland", "addresses": 256, "organisation": { "name": "Google CWB PNI", "info": "GOOGLE-CORP-WAN-BB", "id": "google-cwb-pni", "url": "https://networksdb.io/ip-addresses-of/google-cwb-pni" } }, { "cidr": "185.25.28.0/23", "first_ip": "185.25.28.0", "last_ip": "185.25.29.255", "countrycode": "CH", "country": "Switzerland", "addresses": 512, "organisation": { "name": "Google CWB Infra", "info": "P2P", "id": "google-cwb-infra", "url": "https://networksdb.io/ip-addresses-of/google-cwb-infra" } }, { "cidr": "104.132.34.0/24", "first_ip": "104.132.34.0", "last_ip": "104.132.34.255", "countrycode": "US", "country": "United States", "addresses": 256, "organisation": { "name": "Google Corporate Network New York", "info": "GOOGLE-CORP-NEWYORK", "id": "google-corporate-network-new-york", "url": "https://networksdb.io/ip-addresses-of/google-corporate-network-new-york" } }, // truncated ... ] }