GET /radar/dns/timeseries

Retrieves normalized query volume to the 1.1.1.1 DNS resolver over time.

Servers

Query parameters

Name Type Required Description
tld[] Array No

Filters results by country code top-level domain (ccTLD).

nodata Boolean No

Specifies whether the response includes empty DNS responses (NODATA).

responseCode String No

Filters results by DNS response code.

Possible values:

  • "NXRRSET"
  • "BADALG"
  • "FORMERR"
  • "BADTRUNC"
  • "NXDOMAIN"
  • "BADSIG"
  • "BADKEY"
  • "NOTZONE"
  • "BADCOOKIE"
  • "SERVFAIL"
  • "BADTIME"
  • "REFUSED"
  • "YXDOMAIN"
  • "NOTAUTH"
  • "BADMODE"
  • "BADNAME"
  • "NOTIMP"
  • "NOERROR"
  • "YXRRSET"
dateEnd[] Array No

End of the date range (inclusive).

location[] Array No

Filters results by location. Specify a comma-separated list of alpha-2 codes. Prefix with - to exclude locations from results. For example, -US,PT excludes results from the US, but includes results from PT.

protocol String No

Filters results by DNS transport protocol.

Possible values:

  • "UDP"
  • "TCP"
  • "HTTPS"
  • "TLS"
dateStart[] Array No

Start of the date range.

aggInterval String No

Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

Possible values:

  • "1h"
  • "1w"
  • "15m"
  • "1d"
dateRange[] Array No

Filters results by date range. For example, use 7d and 7dcontrol to compare this week with the previous week. Use this parameter or set specific start and end dates (dateStart and dateEnd parameters).

asn[] Array No

Filters results by Autonomous System. Specify one or more Autonomous System Numbers (ASNs) as a comma-separated list. Prefix with - to exclude ASNs from results. For example, -174, 3356 excludes results from AS174, but includes results from AS3356.

name[] Array No

Array of names used to label the series in the response.

format String No

Format in which results will be returned.

Possible values:

  • "CSV"
  • "JSON"
queryType String No

Filters results by DNS query type.

Possible values:

  • "DS"
  • "ANY"
  • "CSYNC"
  • "MINFO"
  • "NS"
  • "NSEC"
  • "NSEC3"
  • "CDS"
  • "NAPTR"
  • "X25"
  • "DOA"
  • "NIMLOC"
  • "UID"
  • "HINFO"
  • "OPT"
  • "MAILB"
  • "TALINK"
  • "RKEY"
  • "MD"
  • "APL"
  • "AXFR"
  • "NB"
  • "NINFO"
  • "WKS"
  • "A"
  • "EUI48"
  • "LOC"
  • "PX"
  • "MR"
  • "LP"
  • "RT"
  • "EUI64"
  • "CDNSKEY"
  • "PTR"
  • "DNSKEY"
  • "HIP"
  • "MAILA"
  • "SINK"
  • "SIG"
  • "AAAA"
  • "NXT"
  • "SSHFP"
  • "ISDN"
  • "SVCB"
  • "GPOS"
  • "OPENPGPKEY"
  • "UNSPEC"
  • "TSIG"
  • "CERT"
  • "DLV"
  • "SRV"
  • "ZONEMD"
  • "DNAME"
  • "IPSECKEY"
  • "RP"
  • "IXFR"
  • "MF"
  • "RRSIG"
  • "ATMA"
  • "DHCID"
  • "A6"
  • "EID"
  • "MB"
  • "SPF"
  • "NBSTAT"
  • "GID"
  • "KX"
  • "TA"
  • "CNAME"
  • "MX"
  • "KEY"
  • "UINFO"
  • "HTTPS"
  • "NULL"
  • "NSEC3PARAM"
  • "TKEY"
  • "TLSA"
  • "TXT"
  • "MG"
  • "AFSDB"
  • "L64"
  • "NID"
  • "SOA"
  • "NSAP"
  • "L32"
  • "SMIMEA"
  • "URI"
  • "CAA"
continent[] Array No

Filters results by continent. Specify a comma-separated list of alpha-2 codes. Prefix with - to exclude continents from results. For example, -EU,NA excludes results from EU, but includes results from NA.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.