API Reference

Radar

DNS

Top

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get top locations by DNS queries

client.Radar.DNS.Top.Locations(ctx, query) (*DNSTopLocationsResponse, error)

GET/radar/dns/top/locations

Retrieves the top locations by DNS queries made to 1.1.1.1 DNS resolver.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

User Details WriteUser Details Read

ParametersExpand Collapse

query DNSTopLocationsParams

ASN param.Field[[]string]Optional

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.

CacheHit param.Field[[]bool]Optional

Filters results based on cache status.

Continent param.Field[[]string]Optional

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.

DateEnd param.Field[[]Time]Optional

End of the date range (inclusive).

DateRange param.Field[[]string]Optional

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).

DateStart param.Field[[]Time]Optional

Start of the date range.

DNSSEC param.Field[[]DNSTopLocationsParamsDNSSEC]Optional

Filters results based on DNSSEC (DNS Security Extensions) support.

const DNSTopLocationsParamsDNSSECInvalid DNSTopLocationsParamsDNSSEC = "INVALID"

const DNSTopLocationsParamsDNSSECInsecure DNSTopLocationsParamsDNSSEC = "INSECURE"

const DNSTopLocationsParamsDNSSECSecure DNSTopLocationsParamsDNSSEC = "SECURE"

const DNSTopLocationsParamsDNSSECOther DNSTopLocationsParamsDNSSEC = "OTHER"

DNSSECAware param.Field[[]DNSTopLocationsParamsDNSSECAware]Optional

Filters results based on DNSSEC (DNS Security Extensions) client awareness.

const DNSTopLocationsParamsDNSSECAwareSupported DNSTopLocationsParamsDNSSECAware = "SUPPORTED"

const DNSTopLocationsParamsDNSSECAwareNotSupported DNSTopLocationsParamsDNSSECAware = "NOT_SUPPORTED"

DNSSECE2E param.Field[[]bool]Optional

Filters results based on DNSSEC-validated answers by end-to-end security status.

Domain param.Field[[]string]Optional

Filters results by domain name.

Format param.Field[DNSTopLocationsParamsFormat]Optional

Format in which results will be returned.

const DNSTopLocationsParamsFormatJson DNSTopLocationsParamsFormat = "JSON"

const DNSTopLocationsParamsFormatCsv DNSTopLocationsParamsFormat = "CSV"

IPVersion param.Field[[]DNSTopLocationsParamsIPVersion]Optional

Filters results by IP version (Ipv4 vs. IPv6).

const DNSTopLocationsParamsIPVersionIPv4 DNSTopLocationsParamsIPVersion = "IPv4"

const DNSTopLocationsParamsIPVersionIPv6 DNSTopLocationsParamsIPVersion = "IPv6"

Limit param.Field[int64]Optional

Limits the number of objects returned in the response.

exclusiveMinimum

minimum0

Location param.Field[[]string]Optional

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.

MatchingAnswer param.Field[[]bool]Optional

Filters results based on whether the queries have a matching answer.

Name param.Field[[]string]Optional

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

Nodata param.Field[[]bool]Optional

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

Protocol param.Field[[]DNSTopLocationsParamsProtocol]Optional

Filters results by DNS transport protocol.

const DNSTopLocationsParamsProtocolUdp DNSTopLocationsParamsProtocol = "UDP"

const DNSTopLocationsParamsProtocolTCP DNSTopLocationsParamsProtocol = "TCP"

const DNSTopLocationsParamsProtocolHTTPS DNSTopLocationsParamsProtocol = "HTTPS"

const DNSTopLocationsParamsProtocolTLS DNSTopLocationsParamsProtocol = "TLS"

QueryType param.Field[[]DNSTopLocationsParamsQueryType]Optional

Filters results by DNS query type.

const DNSTopLocationsParamsQueryTypeA DNSTopLocationsParamsQueryType = "A"

const DNSTopLocationsParamsQueryTypeAAAA DNSTopLocationsParamsQueryType = "AAAA"

const DNSTopLocationsParamsQueryTypeA6 DNSTopLocationsParamsQueryType = "A6"

const DNSTopLocationsParamsQueryTypeAfsdb DNSTopLocationsParamsQueryType = "AFSDB"

const DNSTopLocationsParamsQueryTypeAny DNSTopLocationsParamsQueryType = "ANY"

const DNSTopLocationsParamsQueryTypeApl DNSTopLocationsParamsQueryType = "APL"

const DNSTopLocationsParamsQueryTypeAtma DNSTopLocationsParamsQueryType = "ATMA"

const DNSTopLocationsParamsQueryTypeAXFR DNSTopLocationsParamsQueryType = "AXFR"

const DNSTopLocationsParamsQueryTypeCAA DNSTopLocationsParamsQueryType = "CAA"

const DNSTopLocationsParamsQueryTypeCdnskey DNSTopLocationsParamsQueryType = "CDNSKEY"

const DNSTopLocationsParamsQueryTypeCds DNSTopLocationsParamsQueryType = "CDS"

const DNSTopLocationsParamsQueryTypeCERT DNSTopLocationsParamsQueryType = "CERT"

const DNSTopLocationsParamsQueryTypeCNAME DNSTopLocationsParamsQueryType = "CNAME"

const DNSTopLocationsParamsQueryTypeCsync DNSTopLocationsParamsQueryType = "CSYNC"

const DNSTopLocationsParamsQueryTypeDhcid DNSTopLocationsParamsQueryType = "DHCID"

const DNSTopLocationsParamsQueryTypeDlv DNSTopLocationsParamsQueryType = "DLV"

const DNSTopLocationsParamsQueryTypeDname DNSTopLocationsParamsQueryType = "DNAME"

const DNSTopLocationsParamsQueryTypeDNSKEY DNSTopLocationsParamsQueryType = "DNSKEY"

const DNSTopLocationsParamsQueryTypeDoa DNSTopLocationsParamsQueryType = "DOA"

const DNSTopLocationsParamsQueryTypeDS DNSTopLocationsParamsQueryType = "DS"

const DNSTopLocationsParamsQueryTypeEid DNSTopLocationsParamsQueryType = "EID"

const DNSTopLocationsParamsQueryTypeEui48 DNSTopLocationsParamsQueryType = "EUI48"

const DNSTopLocationsParamsQueryTypeEui64 DNSTopLocationsParamsQueryType = "EUI64"

const DNSTopLocationsParamsQueryTypeGpos DNSTopLocationsParamsQueryType = "GPOS"

const DNSTopLocationsParamsQueryTypeGid DNSTopLocationsParamsQueryType = "GID"

const DNSTopLocationsParamsQueryTypeHinfo DNSTopLocationsParamsQueryType = "HINFO"

const DNSTopLocationsParamsQueryTypeHip DNSTopLocationsParamsQueryType = "HIP"

const DNSTopLocationsParamsQueryTypeHTTPS DNSTopLocationsParamsQueryType = "HTTPS"

const DNSTopLocationsParamsQueryTypeIpseckey DNSTopLocationsParamsQueryType = "IPSECKEY"

const DNSTopLocationsParamsQueryTypeIsdn DNSTopLocationsParamsQueryType = "ISDN"

const DNSTopLocationsParamsQueryTypeIxfr DNSTopLocationsParamsQueryType = "IXFR"

const DNSTopLocationsParamsQueryTypeKey DNSTopLocationsParamsQueryType = "KEY"

const DNSTopLocationsParamsQueryTypeKx DNSTopLocationsParamsQueryType = "KX"

const DNSTopLocationsParamsQueryTypeL32 DNSTopLocationsParamsQueryType = "L32"

const DNSTopLocationsParamsQueryTypeL64 DNSTopLocationsParamsQueryType = "L64"

const DNSTopLocationsParamsQueryTypeLOC DNSTopLocationsParamsQueryType = "LOC"

const DNSTopLocationsParamsQueryTypeLp DNSTopLocationsParamsQueryType = "LP"

const DNSTopLocationsParamsQueryTypeMaila DNSTopLocationsParamsQueryType = "MAILA"

const DNSTopLocationsParamsQueryTypeMailb DNSTopLocationsParamsQueryType = "MAILB"

const DNSTopLocationsParamsQueryTypeMB DNSTopLocationsParamsQueryType = "MB"

const DNSTopLocationsParamsQueryTypeMd DNSTopLocationsParamsQueryType = "MD"

const DNSTopLocationsParamsQueryTypeMf DNSTopLocationsParamsQueryType = "MF"

const DNSTopLocationsParamsQueryTypeMg DNSTopLocationsParamsQueryType = "MG"

const DNSTopLocationsParamsQueryTypeMinfo DNSTopLocationsParamsQueryType = "MINFO"

const DNSTopLocationsParamsQueryTypeMr DNSTopLocationsParamsQueryType = "MR"

const DNSTopLocationsParamsQueryTypeMX DNSTopLocationsParamsQueryType = "MX"

const DNSTopLocationsParamsQueryTypeNAPTR DNSTopLocationsParamsQueryType = "NAPTR"

const DNSTopLocationsParamsQueryTypeNb DNSTopLocationsParamsQueryType = "NB"

const DNSTopLocationsParamsQueryTypeNbstat DNSTopLocationsParamsQueryType = "NBSTAT"

const DNSTopLocationsParamsQueryTypeNid DNSTopLocationsParamsQueryType = "NID"

const DNSTopLocationsParamsQueryTypeNimloc DNSTopLocationsParamsQueryType = "NIMLOC"

const DNSTopLocationsParamsQueryTypeNinfo DNSTopLocationsParamsQueryType = "NINFO"

const DNSTopLocationsParamsQueryTypeNS DNSTopLocationsParamsQueryType = "NS"

const DNSTopLocationsParamsQueryTypeNsap DNSTopLocationsParamsQueryType = "NSAP"

const DNSTopLocationsParamsQueryTypeNsec DNSTopLocationsParamsQueryType = "NSEC"

const DNSTopLocationsParamsQueryTypeNsec3 DNSTopLocationsParamsQueryType = "NSEC3"

const DNSTopLocationsParamsQueryTypeNsec3Param DNSTopLocationsParamsQueryType = "NSEC3PARAM"

const DNSTopLocationsParamsQueryTypeNull DNSTopLocationsParamsQueryType = "NULL"

const DNSTopLocationsParamsQueryTypeNxt DNSTopLocationsParamsQueryType = "NXT"

const DNSTopLocationsParamsQueryTypeOpenpgpkey DNSTopLocationsParamsQueryType = "OPENPGPKEY"

const DNSTopLocationsParamsQueryTypeOpt DNSTopLocationsParamsQueryType = "OPT"

const DNSTopLocationsParamsQueryTypePTR DNSTopLocationsParamsQueryType = "PTR"

const DNSTopLocationsParamsQueryTypePx DNSTopLocationsParamsQueryType = "PX"

const DNSTopLocationsParamsQueryTypeRkey DNSTopLocationsParamsQueryType = "RKEY"

const DNSTopLocationsParamsQueryTypeRp DNSTopLocationsParamsQueryType = "RP"

const DNSTopLocationsParamsQueryTypeRrsig DNSTopLocationsParamsQueryType = "RRSIG"

const DNSTopLocationsParamsQueryTypeRt DNSTopLocationsParamsQueryType = "RT"

const DNSTopLocationsParamsQueryTypeSig DNSTopLocationsParamsQueryType = "SIG"

const DNSTopLocationsParamsQueryTypeSink DNSTopLocationsParamsQueryType = "SINK"

const DNSTopLocationsParamsQueryTypeSMIMEA DNSTopLocationsParamsQueryType = "SMIMEA"

const DNSTopLocationsParamsQueryTypeSOA DNSTopLocationsParamsQueryType = "SOA"

const DNSTopLocationsParamsQueryTypeSPF DNSTopLocationsParamsQueryType = "SPF"

const DNSTopLocationsParamsQueryTypeSRV DNSTopLocationsParamsQueryType = "SRV"

const DNSTopLocationsParamsQueryTypeSSHFP DNSTopLocationsParamsQueryType = "SSHFP"

const DNSTopLocationsParamsQueryTypeSVCB DNSTopLocationsParamsQueryType = "SVCB"

const DNSTopLocationsParamsQueryTypeTa DNSTopLocationsParamsQueryType = "TA"

const DNSTopLocationsParamsQueryTypeTalink DNSTopLocationsParamsQueryType = "TALINK"

const DNSTopLocationsParamsQueryTypeTkey DNSTopLocationsParamsQueryType = "TKEY"

const DNSTopLocationsParamsQueryTypeTLSA DNSTopLocationsParamsQueryType = "TLSA"

const DNSTopLocationsParamsQueryTypeTSIG DNSTopLocationsParamsQueryType = "TSIG"

const DNSTopLocationsParamsQueryTypeTXT DNSTopLocationsParamsQueryType = "TXT"

const DNSTopLocationsParamsQueryTypeUinfo DNSTopLocationsParamsQueryType = "UINFO"

const DNSTopLocationsParamsQueryTypeUID DNSTopLocationsParamsQueryType = "UID"

const DNSTopLocationsParamsQueryTypeUnspec DNSTopLocationsParamsQueryType = "UNSPEC"

const DNSTopLocationsParamsQueryTypeURI DNSTopLocationsParamsQueryType = "URI"

const DNSTopLocationsParamsQueryTypeWks DNSTopLocationsParamsQueryType = "WKS"

const DNSTopLocationsParamsQueryTypeX25 DNSTopLocationsParamsQueryType = "X25"

const DNSTopLocationsParamsQueryTypeZonemd DNSTopLocationsParamsQueryType = "ZONEMD"

ResponseCode param.Field[[]DNSTopLocationsParamsResponseCode]Optional

Filters results by DNS response code.

const DNSTopLocationsParamsResponseCodeNoerror DNSTopLocationsParamsResponseCode = "NOERROR"

const DNSTopLocationsParamsResponseCodeFormerr DNSTopLocationsParamsResponseCode = "FORMERR"

const DNSTopLocationsParamsResponseCodeServfail DNSTopLocationsParamsResponseCode = "SERVFAIL"

const DNSTopLocationsParamsResponseCodeNxdomain DNSTopLocationsParamsResponseCode = "NXDOMAIN"

const DNSTopLocationsParamsResponseCodeNotimp DNSTopLocationsParamsResponseCode = "NOTIMP"

const DNSTopLocationsParamsResponseCodeRefused DNSTopLocationsParamsResponseCode = "REFUSED"

const DNSTopLocationsParamsResponseCodeYxdomain DNSTopLocationsParamsResponseCode = "YXDOMAIN"

const DNSTopLocationsParamsResponseCodeYxrrset DNSTopLocationsParamsResponseCode = "YXRRSET"

const DNSTopLocationsParamsResponseCodeNxrrset DNSTopLocationsParamsResponseCode = "NXRRSET"

const DNSTopLocationsParamsResponseCodeNotauth DNSTopLocationsParamsResponseCode = "NOTAUTH"

const DNSTopLocationsParamsResponseCodeNotzone DNSTopLocationsParamsResponseCode = "NOTZONE"

const DNSTopLocationsParamsResponseCodeBadsig DNSTopLocationsParamsResponseCode = "BADSIG"

const DNSTopLocationsParamsResponseCodeBadkey DNSTopLocationsParamsResponseCode = "BADKEY"

const DNSTopLocationsParamsResponseCodeBadtime DNSTopLocationsParamsResponseCode = "BADTIME"

const DNSTopLocationsParamsResponseCodeBadmode DNSTopLocationsParamsResponseCode = "BADMODE"

const DNSTopLocationsParamsResponseCodeBadname DNSTopLocationsParamsResponseCode = "BADNAME"

const DNSTopLocationsParamsResponseCodeBadalg DNSTopLocationsParamsResponseCode = "BADALG"

const DNSTopLocationsParamsResponseCodeBadtrunc DNSTopLocationsParamsResponseCode = "BADTRUNC"

const DNSTopLocationsParamsResponseCodeBadcookie DNSTopLocationsParamsResponseCode = "BADCOOKIE"

ResponseTTL param.Field[[]DNSTopLocationsParamsResponseTTL]Optional

Filters results by DNS response TTL.

const DNSTopLocationsParamsResponseTTLLte1M DNSTopLocationsParamsResponseTTL = "LTE_1M"

const DNSTopLocationsParamsResponseTTLGt1MLte5M DNSTopLocationsParamsResponseTTL = "GT_1M_LTE_5M"

const DNSTopLocationsParamsResponseTTLGt5MLte15M DNSTopLocationsParamsResponseTTL = "GT_5M_LTE_15M"

const DNSTopLocationsParamsResponseTTLGt15MLte1H DNSTopLocationsParamsResponseTTL = "GT_15M_LTE_1H"

const DNSTopLocationsParamsResponseTTLGt1HLte1D DNSTopLocationsParamsResponseTTL = "GT_1H_LTE_1D"

const DNSTopLocationsParamsResponseTTLGt1DLte1W DNSTopLocationsParamsResponseTTL = "GT_1D_LTE_1W"

const DNSTopLocationsParamsResponseTTLGt1W DNSTopLocationsParamsResponseTTL = "GT_1W"

TLD param.Field[[]string]Optional

Filters results by top-level domain.

ReturnsExpand Collapse

type DNSTopLocationsResponse struct{…}

Meta DNSTopLocationsResponseMeta

Metadata for the results.

ConfidenceInfo DNSTopLocationsResponseMetaConfidenceInfo

Annotations []DNSTopLocationsResponseMetaConfidenceInfoAnnotation

DataSource DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource

Data source for annotations.

One of the following:

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "CT"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "FW"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "NET"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTopLocationsResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"

Description string

EndDate Time

formatdate-time

EventType DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"

const DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTopLocationsResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"

IsInstantaneous bool

Whether event is a single point in time or a time range.

LinkedURL string

formaturi

StartDate Time

formatdate-time

Tags []stringOptional

Level int64

Provides an indication of how much confidence Cloudflare has in the data.

DateRange []DNSTopLocationsResponseMetaDateRange

EndTime Time

Adjusted end of date range.

formatdate-time

StartTime Time

Adjusted start of date range.

formatdate-time

LastUpdated Time

Timestamp of the last dataset update.

formatdate-time

Normalization DNSTopLocationsResponseMetaNormalization

Normalization method applied to the results. Refer to Normalization methods.

One of the following:

const DNSTopLocationsResponseMetaNormalizationPercentage DNSTopLocationsResponseMetaNormalization = "PERCENTAGE"

const DNSTopLocationsResponseMetaNormalizationMin0Max DNSTopLocationsResponseMetaNormalization = "MIN0_MAX"

const DNSTopLocationsResponseMetaNormalizationMinMax DNSTopLocationsResponseMetaNormalization = "MIN_MAX"

const DNSTopLocationsResponseMetaNormalizationRawValues DNSTopLocationsResponseMetaNormalization = "RAW_VALUES"

const DNSTopLocationsResponseMetaNormalizationPercentageChange DNSTopLocationsResponseMetaNormalization = "PERCENTAGE_CHANGE"

const DNSTopLocationsResponseMetaNormalizationRollingAverage DNSTopLocationsResponseMetaNormalization = "ROLLING_AVERAGE"

const DNSTopLocationsResponseMetaNormalizationOverlappedPercentage DNSTopLocationsResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"

const DNSTopLocationsResponseMetaNormalizationRatio DNSTopLocationsResponseMetaNormalization = "RATIO"

Units []DNSTopLocationsResponseMetaUnit

Measurement units for the results.

Name string

Value string

Top0 []DNSTopLocationsResponseTop0

ClientCountryAlpha2 string

ClientCountryName string

Value string

A numeric string.

Get top locations by DNS queries

Go

HTTP

TypeScript

Python

Go

Terraform

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/cloudflare-go"
  "github.com/stainless-sdks/cloudflare-go/option"
  "github.com/stainless-sdks/cloudflare-go/radar"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  response, err := client.Radar.DNS.Top.Locations(context.TODO(), radar.DNSTopLocationsParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Meta)
}

200 example

{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z",
            "tags": [
              "BOT_CLASS"
            ]
          }
        ],
        "level": 0
      },
      "dateRange": [
        {
          "endTime": "2022-09-17T10:22:57.555Z",
          "startTime": "2022-09-16T10:22:57.555Z"
        }
      ],
      "lastUpdated": "2019-12-27T18:11:19.117Z",
      "normalization": "PERCENTAGE",
      "units": [
        {
          "name": "*",
          "value": "requests"
        }
      ]
    },
    "top_0": [
      {
        "clientCountryAlpha2": "PT",
        "clientCountryName": "Portugal",
        "value": "10"
      }
    ]
  },
  "success": true
}

Returns Examples

200 example

{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z",
            "tags": [
              "BOT_CLASS"
            ]
          }
        ],
        "level": 0
      },
      "dateRange": [
        {
          "endTime": "2022-09-17T10:22:57.555Z",
          "startTime": "2022-09-16T10:22:57.555Z"
        }
      ],
      "lastUpdated": "2019-12-27T18:11:19.117Z",
      "normalization": "PERCENTAGE",
      "units": [
        {
          "name": "*",
          "value": "requests"
        }
      ]
    },
    "top_0": [
      {
        "clientCountryAlpha2": "PT",
        "clientCountryName": "Portugal",
        "value": "10"
      }
    ]
  },
  "success": true
}