API access to the DNS repository is available starting at $20 per month. Please contact sales@noc.org to get started.
The DNSRepo API gives you ulimited access to our database. You can do a search on all records or look at the IP history of a domain name. We currently support 4 types of access: Full DB search, IPv4 lookup, Domain lookup and history and a reverse IP search.
Every request will go to our API URL bellow and will require your API key (provided by the apikey variable). A limit option is also available to increase or decrease the number of records in the response (default to 500)
URL: https://dnsarchive.net/api/?apikey[APIKEY]
apikey: Provided by sales@noc.org
limit: [500]
To perform a full DB search, you need to specify the search variable in the API call like this:
Variable: &search=[SEARCH TERM]
Example query would look like this:
curl "https://dnsarchive.net/api/?apikey[APIKEY]&search=onesignal.com"
This would generate a JSON output like this
{
"domain": "onesignal.com.",
"ipv4": [
"104.18.225.52",
"104.18.226.52"
],
"ipv6": [
"2606:4700::6812:e134",
"2606:4700::6812:e234"
],
"mx": [
"alt1.aspmx.l.google.com.",
"alt2.aspmx.l.google.com.",
"aspmx2.googlemail.com.",
"aspmx3.googlemail.com.",
"aspmx.l.google.com."
],
"ns": [
"gail.ns.cloudflare.com.",
"vin.ns.cloudflare.com."
]
},
For an IPv4 lookup, to find all domains behind an IP, you need to add the ip variable to your API call.
Variable: &ip=[IPv4]
Example query would look like this:
curl "https://dnsarchive.net/api/?apikey[APIKEY]&ip=1.1.1.1"
For an domain lookup, and to find the DNS history for it, you need to add the domain variable to your API call.
Variable: &domain=[domain]
Example query would look like this:
curl "https://dnsarchive.net/api/?apikey[APIKEY]&domain=www.cleanbrowsing.org"
The domain history will be provided with the unix time stamp, similar to this:
"1638896641": {
"domain": "cleanbrowsing.org.",
"ipv4": [
"45.32.155.191"
],
"ns": [
"ns6.dns-noc.net.",
"ns6.dns-noc.org.",
"ns9.dns-noc.net.",
"ns9.dns-noc.org."
],
"mx": [
"alt1.aspmx.l.google.com.",
"alt2.aspmx.l.google.com.",
"alt3.aspmx.l.google.com.",
"aspmx.l.google.com."
]
},
"1638766384": {
"domain": "cleanbrowsing.org.",
"ipv4": [
"45.32.221.106"
],