{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Retrieves the top autonomous systems by DNS queries made to 1.1.1.1 DNS resolver.","properties":{"query":{"type":"object","properties":{"limit":{"description":"Limits the number of objects returned in the response.","type":"integer","default":5,"exclusiveMinimum":0,"examples":[5]},"name":{"description":"Array of names used to label the series in the response.","type":"array","items":{"type":"string","examples":["main_series"]}},"dateRange":{"description":"Filters results by relative date range ending at the current time, with each value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>w` for weeks (up to `52w`). Append `control` to request the equivalent previous period for comparison: the comparison window is shifted back by the current window's length rounded up to a whole number of weeks, so it keeps the same weekday alignment and does not overlap the current window (e.g. `7dcontrol` covers days -14 to -7, `10dcontrol` covers days -24 to -14). For example, pass `7d` and `7dcontrol` to compare this week with the previous week. All series must resolve to the same duration as the main series; relative ranges (including `control`) satisfy this automatically. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).","type":"array","items":{"pattern":"^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$","type":"string","examples":["7d"]},"examples":["7d"]},"dateStart":{"description":"Start of the date range. Alternative to `dateRange`; provide together with `dateEnd`. When requesting comparison series, every series must resolve to the same duration as the main series. Each `dateStart`/`dateEnd` is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected.","type":"array","items":{"format":"date-time","type":"string"},"examples":["2023-09-01T11:41:33.782Z"]},"dateEnd":{"description":"End of the date range (inclusive). Alternative to `dateRange`; provide together with `dateStart`. When requesting comparison series, every series must resolve to the same duration as the main series. Each `dateStart`/`dateEnd` is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected.","type":"array","items":{"format":"date-time","type":"string"},"examples":["2023-09-01T11:41:33.782Z"]},"asn":{"description":"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.","type":"array","items":{"type":"string"},"examples":["15169"]},"location":{"description":"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.","type":"array","items":{"type":"string"},"examples":["US,CA"]},"continent":{"description":"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.","type":"array","items":{"type":"string"},"examples":["EU,NA"]},"domain":{"description":"Filters results by domain name. When set, no other DNS filter may be used — only date filtering (`dateRange`, or `dateStart`/`dateEnd`) is allowed — and the date range cannot exceed 31 days.","type":"array","items":{"maxLength":253,"minLength":1,"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)\\.)+(?:[A-Za-z]{2,63})$","type":"string","examples":["google.com"]},"examples":["google.com"]},"cacheHit":{"description":"Filters results based on cache status.","type":"array","items":{"type":"boolean"}},"nodata":{"description":"Specifies whether the response includes empty DNS responses (NODATA).","type":"array","items":{"type":"boolean"},"default":["true"]},"protocol":{"description":"Filters results by DNS transport protocol.","type":"array","items":{"enum":["UDP","TCP","HTTPS","TLS"],"type":"string"}},"queryType":{"description":"Filters results by DNS query type.","type":"array","items":{"enum":["A","AAAA","A6","AFSDB","ANY","APL","ATMA","AXFR","CAA","CDNSKEY","CDS","CERT","CNAME","CSYNC","DHCID","DLV","DNAME","DNSKEY","DOA","DS","EID","EUI48","EUI64","GPOS","GID","HINFO","HIP","HTTPS","IPSECKEY","ISDN","IXFR","KEY","KX","L32","L64","LOC","LP","MAILA","MAILB","MB","MD","MF","MG","MINFO","MR","MX","NAPTR","NB","NBSTAT","NID","NIMLOC","NINFO","NS","NSAP","NSEC","NSEC3","NSEC3PARAM","NULL","NXT","OPENPGPKEY","OPT","PTR","PX","RKEY","RP","RRSIG","RT","SIG","SINK","SMIMEA","SOA","SPF","SRV","SSHFP","SVCB","TA","TALINK","TKEY","TLSA","TSIG","TXT","UINFO","UID","UNSPEC","URI","WKS","X25","ZONEMD"],"type":["string","null"]}},"responseCode":{"description":"Filters results by DNS response code.","type":"array","items":{"enum":["NOERROR","FORMERR","SERVFAIL","NXDOMAIN","NOTIMP","REFUSED","YXDOMAIN","YXRRSET","NXRRSET","NOTAUTH","NOTZONE","BADSIG","BADKEY","BADTIME","BADMODE","BADNAME","BADALG","BADTRUNC","BADCOOKIE"],"type":"string"}},"responseTtl":{"description":"Filters results by DNS response TTL.","type":"array","items":{"enum":["LTE_1M","GT_1M_LTE_5M","GT_5M_LTE_15M","GT_15M_LTE_1H","GT_1H_LTE_1D","GT_1D_LTE_1W","GT_1W"],"type":"string"}},"dnssec":{"description":"Filters results based on DNSSEC (DNS Security Extensions) support.","type":"array","items":{"enum":["INVALID","INSECURE","SECURE","OTHER"],"type":"string"}},"dnssecAware":{"description":"Filters results based on DNSSEC (DNS Security Extensions) client awareness.","type":"array","items":{"enum":["SUPPORTED","NOT_SUPPORTED"],"type":"string"}},"dnssecE2e":{"description":"Filters results based on DNSSEC-validated answers by end-to-end security status.","type":"array","items":{"type":"boolean"}},"ipVersion":{"description":"Filters results by IP version (Ipv4 vs. IPv6).","type":"array","items":{"enum":["IPv4","IPv6"],"type":"string"},"examples":["IPv4"]},"matchingAnswer":{"description":"Filters results based on whether the queries have a matching answer.","type":"array","items":{"type":"boolean"}},"format":{"description":"Format in which results will be returned.","type":"string","enum":["JSON","CSV"],"examples":["json"]}},"required":[],"additionalProperties":false}},"required":[],"additionalProperties":false},"name":"Get top ASes by DNS queries","id":"cloudflare.radar-get-dns-top-ases","example":{},"maxRequests":1,"summary":false}}