Radar

Radar

Radar.AI

Radar.AI.Bots

Methods

summaryV2(, , ):
get/radar/ai/bots/summary/{dimension}

Retrieves an aggregated summary of AI bots HTTP requests grouped by the specified dimension.

timeseries(, ):
get/radar/ai/bots/timeseries

Retrieves AI bots HTTP request volume over time.

timeseriesGroups(, , ):
get/radar/ai/bots/timeseries_groups/{dimension}

Retrieves the distribution of HTTP requests from AI bots, grouped by chosen the specified dimension over time.

Radar.AI.Bots.Summary

Methods

userAgent(, ):
Deprecated
get/radar/ai/bots/summary/user_agent

Deprecated

Retrieves the distribution of traffic by AI user agent.

RadarAI

Inference

Radar.AI.Inference

Methods

summaryV2(, , ):
get/radar/ai/inference/summary/{dimension}

Retrieves an aggregated summary of unique accounts using Workers AI inference grouped by the specified dimension.

timeseriesGroupsV2(, , ):
get/radar/ai/inference/timeseries_groups/{dimension}

Retrieves the distribution of unique accounts using Workers AI inference, grouped by the specified dimension over time.

Radar.AI.Inference.Summary

Methods

model(, ):
Deprecated
get/radar/ai/inference/summary/model

Retrieves the distribution of unique accounts by model.

task(, ):
Deprecated
get/radar/ai/inference/summary/task

Retrieves the distribution of unique accounts by task.

RadarAIInference

Timeseries Groups

Radar.AI.Inference.TimeseriesGroups

Radar.AI.Inference.TimeseriesGroups.Summary

Methods

model(, ):
Deprecated
get/radar/ai/inference/timeseries_groups/model

Retrieves the distribution of unique accounts by model over time.

task(, ):
Deprecated
get/radar/ai/inference/timeseries_groups/task

Retrieves the distribution of unique accounts by task over time.

RadarAI

Timeseries Groups

Radar.AI.TimeseriesGroups

Methods

userAgent(, ):
Deprecated
get/radar/ai/bots/timeseries_groups/user_agent

Retrieves the distribution of traffic by AI user agent over time.

summary(, , ):
Deprecated
get/radar/ai/bots/summary/{dimension}

Deprecated

Retrieves an aggregated summary of AI bots HTTP requests grouped by the specified dimension.

timeseries(, ):
Deprecated
get/radar/ai/bots/timeseries

Deprecated

Retrieves AI bots HTTP request volume over time.

timeseriesGroups(, , ):
Deprecated
get/radar/ai/bots/timeseries_groups/{dimension}

Retrieves the distribution of HTTP requests from AI bots, grouped by chosen the specified dimension over time.

RadarAI

To Markdown

Radar.AI.ToMarkdown

Methods

create(, , ): <>
Deprecated
post/accounts/{account_id}/ai/tomarkdown

Deprecated

Use AI > To Markdown instead.

Convert Files into Markdown

Radar

Annotations

Radar.Annotations

Methods

list(, ):
get/radar/annotations

Retrieves the latest annotations.

Radar.Annotations.Outages

Methods

get(, ):
get/radar/annotations/outages

Retrieves the latest Internet outages and anomalies.

locations(, ):
get/radar/annotations/outages/locations

Retrieves the number of outages by location.

Radar

AS112

Radar.AS112

Methods

timeseries(, ):
get/radar/as112/timeseries

Retrieves the AS112 DNS queries over time.

summaryV2(, , ):
get/radar/as112/summary/{dimension}

Retrieves the distribution of AS112 queries by the specified dimension.

timeseriesGroupsV2(, , ):
get/radar/as112/timeseries_groups/{dimension}

Retrieves the distribution of AS112 queries grouped by dimension over time.

RadarAS112

Summary

Radar.AS112.Summary

Methods

dnssec(, ):
Deprecated
get/radar/as112/summary/dnssec

Deprecated

Retrieves the distribution of DNS queries to AS112 by DNSSEC (DNS Security Extensions) support.

edns(, ):
Deprecated
get/radar/as112/summary/edns

Deprecated

Retrieves the distribution of DNS queries to AS112 by EDNS (Extension Mechanisms for DNS) support.

ipVersion(, ):
Deprecated
get/radar/as112/summary/ip_version

Deprecated

Retrieves the distribution of DNS queries to AS112 by IP version.

protocol(, ):
Deprecated
get/radar/as112/summary/protocol

Deprecated

Retrieves the distribution of DNS queries to AS112 by protocol.

queryType(, ):
Deprecated
get/radar/as112/summary/query_type

Deprecated

Retrieves the distribution of DNS queries to AS112 by type.

responseCodes(, ):
Deprecated
get/radar/as112/summary/response_codes

Deprecated

Retrieves the distribution of AS112 DNS requests classified by response code.

RadarAS112

Timeseries Groups

Radar.AS112.TimeseriesGroups

Methods

protocol(, ):
Deprecated
get/radar/as112/timeseries_groups/protocol

Retrieves the distribution of AS112 DNS requests classified by protocol over time.

queryType(, ):
Deprecated
get/radar/as112/timeseries_groups/query_type

Retrieves the distribution of AS112 DNS queries by type over time.

responseCodes(, ):
Deprecated
get/radar/as112/timeseries_groups/response_codes

Retrieves the distribution of AS112 DNS requests classified by response code over time.

dnssec(, ):
Deprecated
get/radar/as112/timeseries_groups/dnssec

Retrieves the distribution of AS112 DNS queries by DNSSEC (DNS Security Extensions) support over time.

edns(, ):
Deprecated
get/radar/as112/timeseries_groups/edns

Retrieves the distribution of AS112 DNS queries by EDNS (Extension Mechanisms for DNS) support over time.

ipVersion(, ):
Deprecated
get/radar/as112/timeseries_groups/ip_version

Retrieves the distribution of AS112 DNS queries by IP version over time.

Radar.AS112.Top

Methods

locations(, ):
get/radar/as112/top/locations

Retrieves the top locations by AS112 DNS queries.

dnssec(, , ):
get/radar/as112/top/locations/dnssec/{dnssec}

Retrieves the top locations of DNS queries to AS112 with DNSSEC (DNS Security Extensions) support.

edns(, , ):
get/radar/as112/top/locations/edns/{edns}

Retrieves the top locations of DNS queries to AS112 with EDNS (Extension Mechanisms for DNS) support.

ipVersion(, , ):
get/radar/as112/top/locations/ip_version/{ip_version}

Retrieves the top locations of DNS queries to AS112 for an IP version.

Radar

Attacks

Radar.Attacks

Radar.Attacks.Layer3

Methods

summaryV2(, , ):
get/radar/attacks/layer3/summary/{dimension}

Retrieves the distribution of layer 3 attacks by the specified dimension.

timeseries(, ):
get/radar/attacks/layer3/timeseries

Retrieves layer 3 attacks over time.

timeseriesGroupsV2(, , ):
get/radar/attacks/layer3/timeseries_groups/{dimension}

Retrieves the distribution of layer 3 attacks grouped by dimension over time.

Radar.Attacks.Layer3.Summary

Methods

bitrate(, ):
Deprecated
get/radar/attacks/layer3/summary/bitrate

Retrieves the distribution of layer 3 attacks by bitrate.

duration(, ):
Deprecated
get/radar/attacks/layer3/summary/duration

Retrieves the distribution of layer 3 attacks by duration.

ipVersion(, ):
Deprecated
get/radar/attacks/layer3/summary/ip_version

Retrieves the distribution of layer 3 attacks by IP version.

protocol(, ):
Deprecated
get/radar/attacks/layer3/summary/protocol

Retrieves the distribution of layer 3 attacks by protocol.

vector(, ):
Deprecated
get/radar/attacks/layer3/summary/vector

Retrieves the distribution of layer 3 attacks by vector.

industry(, ):
Deprecated
get/radar/attacks/layer3/summary/industry

Retrieves the distribution of layer 3 attacks by targeted industry.

vertical(, ):
Deprecated
get/radar/attacks/layer3/summary/vertical

Retrieves the distribution of layer 3 attacks by targeted vertical.

RadarAttacksLayer3

Timeseries Groups

Radar.Attacks.Layer3.TimeseriesGroups

Methods

industry(, ):
Deprecated
get/radar/attacks/layer3/timeseries_groups/industry

Retrieves the distribution of layer 3 attacks by targeted industry over time.

ipVersion(, ):
Deprecated
get/radar/attacks/layer3/timeseries_groups/ip_version

Retrieves the distribution of layer 3 attacks by IP version over time.

protocol(, ):
Deprecated
get/radar/attacks/layer3/timeseries_groups/protocol

Retrieves the distribution of layer 3 attacks by protocol over time.

vector(, ):
Deprecated
get/radar/attacks/layer3/timeseries_groups/vector

Retrieves the distribution of layer 3 attacks by vector over time.

vertical(, ):
Deprecated
get/radar/attacks/layer3/timeseries_groups/vertical

Retrieves the distribution of layer 3 attacks by targeted vertical over time.

bitrate(, ):
Deprecated
get/radar/attacks/layer3/timeseries_groups/bitrate

Retrieves the distribution of layer 3 attacks by bitrate over time.

duration(, ):
Deprecated
get/radar/attacks/layer3/timeseries_groups/duration

Retrieves the distribution of layer 3 attacks by duration over time.

Radar.Attacks.Layer3.Top

Methods

attacks(, ):
get/radar/attacks/layer3/top/attacks

Retrieves the top layer 3 attacks from origin to target location. Values are a percentage out of the total layer 3 attacks (with billing country). You can optionally limit the number of attacks by origin/target location (useful if all the top attacks are from or to the same location).

industry(, ):
Deprecated
get/radar/attacks/layer3/top/industry

This endpoint is deprecated. To continue getting this data, switch to the summary by industry endpoint.

vertical(, ):
Deprecated
get/radar/attacks/layer3/top/vertical

This endpoint is deprecated. To continue getting this data, switch to the summary by vertical endpoint.

Radar.Attacks.Layer3.Top.Locations

Methods

origin(, ):
get/radar/attacks/layer3/top/locations/origin

Retrieves the origin locations of layer 3 attacks.

target(, ):
get/radar/attacks/layer3/top/locations/target

Retrieves the target locations of layer 3 attacks.

Radar.Attacks.Layer7

Methods

summaryV2(, , ):
get/radar/attacks/layer7/summary/{dimension}

Retrieves the distribution of layer 7 attacks by the specified dimension.

timeseries(, ):
get/radar/attacks/layer7/timeseries

Retrieves layer 7 attacks over time.

timeseriesGroupsV2(, , ):
get/radar/attacks/layer7/timeseries_groups/{dimension}

Retrieves the distribution of layer 7 attacks grouped by dimension over time.

Radar.Attacks.Layer7.Summary

Methods

ipVersion(, ):
Deprecated
get/radar/attacks/layer7/summary/ip_version

Retrieves the distribution of layer 7 attacks by IP version.

httpMethod(, ):
Deprecated
get/radar/attacks/layer7/summary/http_method

Retrieves the distribution of layer 7 attacks by HTTP method.

httpVersion(, ):
Deprecated
get/radar/attacks/layer7/summary/http_version

Retrieves the distribution of layer 7 attacks by HTTP version.

managedRules(, ):
Deprecated
get/radar/attacks/layer7/summary/managed_rules

Retrieves the distribution of layer 7 attacks by managed rules.

mitigationProduct(, ):
Deprecated
get/radar/attacks/layer7/summary/mitigation_product

Retrieves the distribution of layer 7 attacks by mitigation product.

industry(, ):
Deprecated
get/radar/attacks/layer7/summary/industry

Retrieves the distribution of layer 7 attacks by targeted industry.

vertical(, ):
Deprecated
get/radar/attacks/layer7/summary/vertical

Retrieves the distribution of layer 7 attacks by targeted vertical.

RadarAttacksLayer7

Timeseries Groups

Radar.Attacks.Layer7.TimeseriesGroups

Methods

industry(, ):
Deprecated
get/radar/attacks/layer7/timeseries_groups/industry

Retrieves the distribution of layer 7 attacks by targeted industry over time.

ipVersion(, ):
Deprecated
get/radar/attacks/layer7/timeseries_groups/ip_version

Retrieves the distribution of layer 7 attacks by IP version used over time.

vertical(, ):
Deprecated
get/radar/attacks/layer7/timeseries_groups/vertical

Retrieves the distribution of layer 7 attacks by targeted vertical over time.

httpMethod(, ):
Deprecated
get/radar/attacks/layer7/timeseries_groups/http_method

Retrieves the distribution of layer 7 attacks by HTTP method over time.

httpVersion(, ):
Deprecated
get/radar/attacks/layer7/timeseries_groups/http_version

Retrieves the distribution of layer 7 attacks by HTTP version over time.

managedRules(, ):
Deprecated
get/radar/attacks/layer7/timeseries_groups/managed_rules

Retrieves the distribution of layer 7 attacks by managed rules over time.

mitigationProduct(, ):
Deprecated
get/radar/attacks/layer7/timeseries_groups/mitigation_product

Retrieves the distribution of layer 7 attacks by mitigation product over time.

Radar.Attacks.Layer7.Top

Methods

attacks(, ):
get/radar/attacks/layer7/top/attacks

Retrieves the top attacks from origin to target location. Values are percentages of the total layer 7 attacks (with billing country). The attack magnitude can be defined by the number of mitigated requests or by the number of zones affected. You can optionally limit the number of attacks by origin/target location (useful if all the top attacks are from or to the same location).

industry(, ):
Deprecated
get/radar/attacks/layer7/top/industry

This endpoint is deprecated. To continue getting this data, switch to the summary by industry endpoint.

vertical(, ):
Deprecated
get/radar/attacks/layer7/top/vertical

This endpoint is deprecated. To continue getting this data, switch to the summary by vertical endpoint.

Radar.Attacks.Layer7.Top.Ases

Methods

origin(, ):
get/radar/attacks/layer7/top/ases/origin

Retrieves the top origin autonomous systems of layer 7 attacks. Values are percentages of the total layer 7 attacks, with the origin autonomous systems determined by the client IP address.

Radar.Attacks.Layer7.Top.Locations

Methods

origin(, ):
get/radar/attacks/layer7/top/locations/origin

Retrieves the top origin locations of layer 7 attacks. Values are percentages of the total layer 7 attacks, with the origin location determined by the client IP address.

target(, ):
get/radar/attacks/layer7/top/locations/target

Retrieves the top target locations of and by layer 7 attacks. Values are a percentage out of the total layer 7 attacks. The target location is determined by the attacked zone's billing country, when available.

Radar.BGP

Methods

timeseries(, ):
get/radar/bgp/timeseries

Retrieves BGP updates over time. When requesting updates for an autonomous system, only BGP updates of type announcement are returned.

RadarBGP

Hijacks

Radar.BGP.Hijacks

Radar.BGP.Hijacks.Events

Methods

list(, ): <>
get/radar/bgp/hijacks/events

Retrieves the BGP hijack events.

Radar.BGP.IPs

Methods

timeseries(, ):
get/radar/bgp/ips/timeseries

Retrieves time series data for the announced IP space count, represented as the number of IPv4 /24s and IPv6 /48s, for a given ASN.

Radar.BGP.Leaks

Radar.BGP.Leaks.Events

Methods

list(, ): <>
get/radar/bgp/leaks/events

Retrieves the BGP route leak events.

RadarBGP

Routes

Radar.BGP.Routes

Methods

moas(, ):
get/radar/bgp/routes/moas

Retrieves all Multi-Origin AS (MOAS) prefixes in the global routing tables.

pfx2as(, ):
get/radar/bgp/routes/pfx2as

Retrieves the prefix-to-ASN mapping from global routing tables.

stats(, ):
get/radar/bgp/routes/stats

Retrieves the BGP routing table stats.

ases(, ):
get/radar/bgp/routes/ases

Retrieves all ASes in the current global routing tables with routing statistics.

realtime(, ):
get/radar/bgp/routes/realtime

Retrieves real-time BGP routes for a prefix, using public real-time data collectors (RouteViews and RIPE RIS).

Radar.BGP.Top

Methods

prefixes(, ):
get/radar/bgp/top/prefixes

Retrieves the top network prefixes by BGP updates.

Radar.BGP.Top.Ases

Methods

get(, ):
get/radar/bgp/top/ases

Retrieves the top autonomous systems by BGP updates (announcements only).

prefixes(, ):
get/radar/bgp/top/ases/prefixes

Retrieves the full list of autonomous systems on the global routing table ordered by announced prefixes count. The data comes from public BGP MRT data archives and updates every 2 hours.

Radar

Bots

Radar.Bots

Methods

list(, ):
get/radar/bots

Retrieves a list of bots.

get(, , ):
get/radar/bots/{bot_slug}

Retrieves the requested bot information.

summary(, , ):
get/radar/bots/summary/{dimension}

Retrieves an aggregated summary of bots HTTP requests grouped by the specified dimension.

timeseries(, ):
get/radar/bots/timeseries

Retrieves bots HTTP request volume over time.

timeseriesGroups(, , ):
get/radar/bots/timeseries_groups/{dimension}

Retrieves the distribution of HTTP requests from bots, grouped by chosen the specified dimension over time.

RadarBots

Web Crawlers

Radar.Bots.WebCrawlers

Methods

summary(, , ):
get/radar/bots/crawlers/summary/{dimension}

Retrieves an aggregated summary of HTTP requests from crawlers, grouped by the specified dimension.

timeseriesGroups(, , ):
get/radar/bots/crawlers/timeseries_groups/{dimension}

Retrieves the distribution of HTTP requests from crawlers, grouped by chosen the specified dimension over time.

Radar.Ct

Methods

summary(, , ):
get/radar/ct/summary/{dimension}

Retrieves an aggregated summary of certificates grouped by the specified dimension.

timeseries(, ):
get/radar/ct/timeseries

Retrieves certificate volume over time.

timeseriesGroups(, , ):
get/radar/ct/timeseries_groups/{dimension}

Retrieves the distribution of certificates grouped by chosen the specified dimension over time.

RadarCt

Authorities

Radar.Ct.Authorities

Methods

get(, , ):
get/radar/ct/authorities/{ca_slug}

Retrieves the requested CA information.

list(, ):
get/radar/ct/authorities

Retrieves a list of certificate authorities.

Radar.Ct.Logs

Methods

get(, , ):
get/radar/ct/logs/{log_slug}

Retrieves the requested certificate log information.

list(, ):
get/radar/ct/logs

Retrieves a list of certificate logs.

Radar

Datasets

Radar.Datasets

Methods

list(, ):
get/radar/datasets

Retrieves a list of datasets.

get(, ):
get/radar/datasets/{alias}

Retrieves the CSV content of a given dataset by alias or ID. When getting the content by alias the latest dataset is returned, optionally filtered by the latest available at a given date.

download(, ):
post/radar/datasets/download

Retrieves an URL to download a single dataset.

Radar.DNS

Methods

summaryV2(, , ):
get/radar/dns/summary/{dimension}

Retrieves the distribution of DNS queries by the specified dimension.

timeseries(, ):
get/radar/dns/timeseries

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

timeseriesGroupsV2(, , ):
get/radar/dns/timeseries_groups/{dimension}

Retrieves the distribution of DNS queries grouped by dimension over time.

RadarDNS

Summary

Radar.DNS.Summary

Methods

cacheHit(, ):
Deprecated
get/radar/dns/summary/cache_hit

Deprecated

Retrieves the distribution of DNS queries by cache status.

dnssec(, ):
Deprecated
get/radar/dns/summary/dnssec

Deprecated

Retrieves the distribution of DNS responses by DNSSEC (DNS Security Extensions) support.

dnssecAware(, ):
Deprecated
get/radar/dns/summary/dnssec_aware

Deprecated

Retrieves the distribution of DNS queries by DNSSEC (DNS Security Extensions) client awareness.

dnssecE2E(, ):
Deprecated
get/radar/dns/summary/dnssec_e2e

Deprecated

Retrieves the distribution of DNSSEC-validated answers by end-to-end security status.

ipVersion(, ):
Deprecated
get/radar/dns/summary/ip_version

Deprecated

Retrieves the distribution of DNS queries by IP version.

matchingAnswer(, ):
Deprecated
get/radar/dns/summary/matching_answer

Deprecated

Retrieves the distribution of DNS queries by matching answers.

protocol(, ):
Deprecated
get/radar/dns/summary/protocol

Deprecated

Retrieves the distribution of DNS queries by DNS transport protocol.

queryType(, ):
Deprecated
get/radar/dns/summary/query_type

Deprecated

Retrieves the distribution of DNS queries by type.

responseCode(, ):
Deprecated
get/radar/dns/summary/response_code

Deprecated

Retrieves the distribution of DNS queries by response code.

responseTTL(, ):
Deprecated
get/radar/dns/summary/response_ttl

Deprecated

Retrieves the distribution of DNS queries by minimum response TTL.

RadarDNS

Timeseries Groups

Radar.DNS.TimeseriesGroups

Methods

cacheHit(, ):
Deprecated
get/radar/dns/timeseries_groups/cache_hit

Retrieves the distribution of DNS queries by cache status over time.

dnssec(, ):
Deprecated
get/radar/dns/timeseries_groups/dnssec

Retrieves the distribution of DNS responses by DNSSEC (DNS Security Extensions) support over time.

dnssecAware(, ):
Deprecated
get/radar/dns/timeseries_groups/dnssec_aware

Retrieves the distribution of DNS queries by DNSSEC (DNS Security Extensions) client awareness over time.

dnssecE2E(, ):
Deprecated
get/radar/dns/timeseries_groups/dnssec_e2e

Retrieves the distribution of DNSSEC-validated answers by end-to-end security status over time.

ipVersion(, ):
Deprecated
get/radar/dns/timeseries_groups/ip_version

Retrieves the distribution of DNS queries by IP version over time.

matchingAnswer(, ):
Deprecated
get/radar/dns/timeseries_groups/matching_answer

Retrieves the distribution of DNS queries by matching answers over time.

protocol(, ):
Deprecated
get/radar/dns/timeseries_groups/protocol

Retrieves the distribution of DNS queries by DNS transport protocol over time.

queryType(, ):
Deprecated
get/radar/dns/timeseries_groups/query_type

Retrieves the distribution of DNS queries by type over time.

responseCode(, ):
Deprecated
get/radar/dns/timeseries_groups/response_code

Retrieves the distribution of DNS queries by response code over time.

responseTTL(, ):
Deprecated
get/radar/dns/timeseries_groups/response_ttl

Retrieves the distribution of DNS queries by minimum answer TTL over time.

Radar.DNS.Top

Methods

ases(, ):
get/radar/dns/top/ases

Retrieves the top autonomous systems by DNS queries made to 1.1.1.1 DNS resolver.

locations(, ):
get/radar/dns/top/locations

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

Radar

Email

Radar.Email

Domain types

RadarEmailSeries{…}
RadarEmailSummary{…}
RadarEmail

Routing

Radar.Email.Routing

Methods

summaryV2(, , ):
get/radar/email/routing/summary/{dimension}

Retrieves the distribution of email routing metrics by the specified dimension.

timeseriesGroupsV2(, , ):
get/radar/email/routing/timeseries_groups/{dimension}

Retrieves the distribution of email routing metrics grouped by dimension over time.

Radar.Email.Routing.Summary

Methods

arc(, ):
Deprecated
get/radar/email/routing/summary/arc

Retrieves the distribution of emails by ARC (Authenticated Received Chain) validation.

dkim(, ):
Deprecated
get/radar/email/routing/summary/dkim

Retrieves the distribution of emails by DKIM (DomainKeys Identified Mail) validation.

dmarc(, ):
Deprecated
get/radar/email/routing/summary/dmarc

Retrieves the distribution of emails by DMARC (Domain-based Message Authentication, Reporting and Conformance) validation.

encrypted(, ):
Deprecated
get/radar/email/routing/summary/encrypted

Retrieves the distribution of emails by encryption status (encrypted vs. not-encrypted).

ipVersion(, ):
Deprecated
get/radar/email/routing/summary/ip_version

Retrieves the distribution of emails by IP version.

spf(, ):
Deprecated
get/radar/email/routing/summary/spf

Retrieves the distribution of emails by SPF (Sender Policy Framework) validation.

RadarEmailRouting

Timeseries Groups

Radar.Email.Routing.TimeseriesGroups

Methods

arc(, ):
Deprecated
get/radar/email/routing/timeseries_groups/arc

Retrieves the distribution of emails by ARC (Authenticated Received Chain) validation over time.

dkim(, ):
Deprecated
get/radar/email/routing/timeseries_groups/dkim

Retrieves the distribution of emails by DKIM (DomainKeys Identified Mail) validation over time.

dmarc(, ):
Deprecated
get/radar/email/routing/timeseries_groups/dmarc

Retrieves the distribution of emails by DMARC (Domain-based Message Authentication, Reporting and Conformance) validation over time.

encrypted(, ):
Deprecated
get/radar/email/routing/timeseries_groups/encrypted

Retrieves the distribution of emails by encryption status (encrypted vs. not-encrypted) over time.

ipVersion(, ):
Deprecated
get/radar/email/routing/timeseries_groups/ip_version

Retrieves the distribution of emails by IP version over time.

spf(, ):
Deprecated
get/radar/email/routing/timeseries_groups/spf

Retrieves the distribution of emails by SPF (Sender Policy Framework) validation over time.

RadarEmail

Security

Radar.Email.Security

Methods

summaryV2(, , ):
get/radar/email/security/summary/{dimension}

Retrieves the distribution of email security metrics by the specified dimension.

timeseriesGroupsV2(, , ):
get/radar/email/security/timeseries_groups/{dimension}

Retrieves the distribution of email security metrics grouped by dimension over time.

Radar.Email.Security.Summary

Methods

arc(, ):
Deprecated
get/radar/email/security/summary/arc

Retrieves the distribution of emails by ARC (Authenticated Received Chain) validation.

dkim(, ):
Deprecated
get/radar/email/security/summary/dkim

Retrieves the distribution of emails by DKIM (DomainKeys Identified Mail) validation.

dmarc(, ):
Deprecated
get/radar/email/security/summary/dmarc

Retrieves the distribution of emails by DMARC (Domain-based Message Authentication, Reporting and Conformance) validation.

malicious(, ):
Deprecated
get/radar/email/security/summary/malicious

Retrieves the distribution of emails by malicious classification.

spam(, ):
Deprecated
get/radar/email/security/summary/spam

Retrieves the proportion of emails by spam classification (spam vs. non-spam).

spf(, ):
Deprecated
get/radar/email/security/summary/spf

Retrieves the distribution of emails by SPF (Sender Policy Framework) validation.

threatCategory(, ):
Deprecated
get/radar/email/security/summary/threat_category

Retrieves the distribution of emails by threat categories.

spoof(, ):
Deprecated
get/radar/email/security/summary/spoof

Retrieves the proportion of emails by spoof classification (spoof vs. non-spoof).

tlsVersion(, ):
Deprecated
get/radar/email/security/summary/tls_version

Retrieves the distribution of emails by TLS version.

RadarEmailSecurity

Timeseries Groups

Radar.Email.Security.TimeseriesGroups

Methods

arc(, ):
Deprecated
get/radar/email/security/timeseries_groups/arc

Retrieves the distribution of emails by ARC (Authenticated Received Chain) validation over time.

dkim(, ):
Deprecated
get/radar/email/security/timeseries_groups/dkim

Retrieves the distribution of emails by DKIM (DomainKeys Identified Mail) validation over time.

dmarc(, ):
Deprecated
get/radar/email/security/timeseries_groups/dmarc

Retrieves the distribution of emails by DMARC (Domain-based Message Authentication, Reporting and Conformance) validation over time.

malicious(, ):
Deprecated
get/radar/email/security/timeseries_groups/malicious

Retrieves the distribution of emails by malicious classification over time.

spam(, ):
Deprecated
get/radar/email/security/timeseries_groups/spam

Retrieves the distribution of emails by spam classification (spam vs. non-spam) over time.

spf(, ):
Deprecated
get/radar/email/security/timeseries_groups/spf

Retrieves the distribution of emails by SPF (Sender Policy Framework) validation over time.

threatCategory(, ):
Deprecated
get/radar/email/security/timeseries_groups/threat_category

Retrieves the distribution of emails by threat category over time.

spoof(, ):
Deprecated
get/radar/email/security/timeseries_groups/spoof

Retrieves the distribution of emails by spoof classification (spoof vs. non-spoof) over time.

tlsVersion(, ):
Deprecated
get/radar/email/security/timeseries_groups/tls_version

Retrieves the distribution of emails by TLS version over time.

Radar.Email.Security.Top

Radar.Email.Security.Top.Tlds

Methods

get(, ):
get/radar/email/security/top/tlds

Retrieves the top TLDs by number of email messages.

Radar.Email.Security.Top.Tlds.Malicious

Methods

get(, , ):
get/radar/email/security/top/tlds/malicious/{malicious}

Retrieves the top TLDs by emails classified as malicious or not.

Radar.Email.Security.Top.Tlds.Spam

Methods

get(, , ):
get/radar/email/security/top/tlds/spam/{spam}

Retrieves the top TLDs by emails classified as spam or not.

Radar.Email.Security.Top.Tlds.Spoof

Methods

get(, , ):
get/radar/email/security/top/tlds/spoof/{spoof}

Retrieves the top TLDs by emails classified as spoof or not.

Radar

Entities

Radar.Entities

Methods

get(, ):
get/radar/entities/ip

Retrieves IP address information.

Radar.Entities.ASNs

Methods

list(, ):
get/radar/entities/asns

Retrieves a list of autonomous systems.

get(, , ):
get/radar/entities/asns/{asn}

Retrieves the requested autonomous system information. (A confidence level below 5 indicates a low level of confidence in the traffic data - normally this happens because Cloudflare has a small amount of traffic from/to this AS). Population estimates come from APNIC (refer to https://labs.apnic.net/?p=526).

rel(, , ):
get/radar/entities/asns/{asn}/rel

Retrieves AS-level relationship for given networks.

asSet(, , ):
get/radar/entities/asns/{asn}/as_set

Retrieves Internet Routing Registry AS-SETs that an AS is a member of.

ip(, ):
get/radar/entities/asns/ip

Retrieves the requested autonomous system information based on IP address. Population estimates come from APNIC (refer to https://labs.apnic.net/?p=526).

RadarEntities

Locations

Radar.Entities.Locations

Methods

list(, ):
get/radar/entities/locations

Retrieves a list of locations.

get(, , ):
get/radar/entities/locations/{location}

Retrieves the requested location information. (A confidence level below 5 indicates a low level of confidence in the traffic data - normally this happens because Cloudflare has a small amount of traffic from/to this location).

Radar

Geolocations

Radar.Geolocations

Methods

list(, ):
get/radar/geolocations

Retrieves a list of geolocations.

get(, , ):
get/radar/geolocations/{geo_id}

Retrieves the requested Geolocation information.

Radar

HTTP

Radar.HTTP

Methods

summaryV2(, , ):
get/radar/http/summary/{dimension}

Retrieves the distribution of HTTP requests by the specified dimension.

timeseries(, ):
get/radar/http/timeseries

Retrieves the HTTP requests over time.

timeseriesGroupsV2(, , ):
get/radar/http/timeseries_groups/{dimension}

Retrieves the distribution of HTTP requests grouped by dimension.

Radar.HTTP.Ases

Methods

get(, ):
get/radar/http/top/ases

Retrieves the top autonomous systems by HTTP requests.

RadarHTTPAses

Bot Class

Radar.HTTP.Ases.BotClass

Methods

get(, , ):
get/radar/http/top/ases/bot_class/{bot_class}

Retrieves the top autonomous systems, by HTTP requests, of the requested bot class.

RadarHTTPAses

Browser Family

Radar.HTTP.Ases.BrowserFamily

Methods

get(, , ):
get/radar/http/top/ases/browser_family/{browser_family}

Retrieves the top autonomous systems, by HTTP requests, of the requested browser family.

RadarHTTPAses

Device Type

Radar.HTTP.Ases.DeviceType

Methods

get(, , ):
get/radar/http/top/ases/device_type/{device_type}

Retrieves the top autonomous systems, by HTTP requests, of the requested device type.

RadarHTTPAses

HTTP Method

Radar.HTTP.Ases.HTTPMethod

Methods

get(, , ):
get/radar/http/top/ases/http_version/{http_version}

Retrieves the top autonomous systems, by HTTP requests, of the requested HTTP version.

RadarHTTPAses

HTTP Protocol

Radar.HTTP.Ases.HTTPProtocol

Methods

get(, , ):
get/radar/http/top/ases/http_protocol/{http_protocol}

Retrieves the top autonomous systems, by HTTP requests, of the requested HTTP protocol.

RadarHTTPAses

IP Version

Radar.HTTP.Ases.IPVersion

Methods

get(, , ):
get/radar/http/top/ases/ip_version/{ip_version}

Retrieves the top autonomous systems, by HTTP requests, of the requested IP version.

Radar.HTTP.Ases.OS

Methods

get(, , ):
get/radar/http/top/ases/os/{os}

Retrieves the top autonomous systems, by HTTP requests, of the requested operating system.

RadarHTTPAses

TLS Version

Radar.HTTP.Ases.TLSVersion

Methods

get(, , ):
get/radar/http/top/ases/tls_version/{tls_version}

Retrieves the top autonomous systems, by HTTP requests, of the requested TLS protocol version.

RadarHTTP

Locations

Radar.HTTP.Locations

Methods

get(, ):
get/radar/http/top/locations

Retrieves the top locations by HTTP requests.

Radar.HTTP.Locations.BotClass

Methods

get(, , ):
get/radar/http/top/locations/bot_class/{bot_class}

Retrieves the top locations, by HTTP requests, of the requested bot class.

RadarHTTPLocations

Browser Family

Radar.HTTP.Locations.BrowserFamily

Methods

get(, , ):
get/radar/http/top/locations/browser_family/{browser_family}

Retrieves the top locations, by HTTP requests, of the requested browser family.

Radar.HTTP.Locations.DeviceType

Methods

get(, , ):
get/radar/http/top/locations/device_type/{device_type}

Retrieves the top locations, by HTTP requests, of the requested device type.

Radar.HTTP.Locations.HTTPMethod

Methods

get(, , ):
get/radar/http/top/locations/http_version/{http_version}

Retrieves the top locations, by HTTP requests, of the requested HTTP version.

RadarHTTPLocations

HTTP Protocol

Radar.HTTP.Locations.HTTPProtocol

Methods

get(, , ):
get/radar/http/top/locations/http_protocol/{http_protocol}

Retrieves the top locations, by HTTP requests, of the requested HTTP protocol.

Radar.HTTP.Locations.IPVersion

Methods

get(, , ):
get/radar/http/top/locations/ip_version/{ip_version}

Retrieves the top locations, by HTTP requests, of the requested IP version.

Radar.HTTP.Locations.OS

Methods

get(, , ):
get/radar/http/top/locations/os/{os}

Retrieves the top locations, by HTTP requests, of the requested operating system.

Radar.HTTP.Locations.TLSVersion

Methods

get(, , ):
get/radar/http/top/locations/tls_version/{tls_version}

Retrieves the top locations, by HTTP requests, of the requested TLS protocol version.

RadarHTTP

Summary

Radar.HTTP.Summary

Methods

botClass(, ):
Deprecated
get/radar/http/summary/bot_class

Deprecated

Retrieves the distribution of bot-generated HTTP requests to genuine human traffic, as classified by Cloudflare. Visit https://developers.cloudflare.com/radar/concepts/bot-classes/ for more information.

deviceType(, ):
Deprecated
get/radar/http/summary/device_type

Deprecated

Retrieves the distribution of HTTP requests generated by mobile, desktop, and other types of devices.

httpProtocol(, ):
Deprecated
get/radar/http/summary/http_protocol

Deprecated

Retrieves the distribution of HTTP requests by HTTP protocol (HTTP vs. HTTPS).

httpVersion(, ):
Deprecated
get/radar/http/summary/http_version

Deprecated

Retrieves the distribution of HTTP requests by HTTP version.

ipVersion(, ):
Deprecated
get/radar/http/summary/ip_version

Deprecated

Retrieves the distribution of HTTP requests by IP version.

os(, ):
Deprecated
get/radar/http/summary/os

Deprecated

Retrieves the distribution of HTTP requests by operating system (Windows, macOS, Android, iOS, and others).

tlsVersion(, ):
Deprecated
get/radar/http/summary/tls_version

Deprecated

Retrieves the distribution of HTTP requests by TLS version.

postQuantum(, ):
Deprecated
get/radar/http/summary/post_quantum

Deprecated

Retrieves the distribution of HTTP requests by post-quantum support.

RadarHTTP

Timeseries Groups

Radar.HTTP.TimeseriesGroups

Methods

tlsVersion(, ):
Deprecated
get/radar/http/timeseries_groups/tls_version

Retrieves the distribution of HTTP requests by TLS version over time.

botClass(, ):
Deprecated
get/radar/http/timeseries_groups/bot_class

Retrieves the distribution of HTTP requests classified as automated or human over time. Visit https://developers.cloudflare.com/radar/concepts/bot-classes/ for more information.

browser(, ):
Deprecated
get/radar/http/timeseries_groups/browser

Retrieves the distribution of HTTP requests by user agent over time.

browserFamily(, ):
Deprecated
get/radar/http/timeseries_groups/browser_family

Retrieves the distribution of HTTP requests by user agent family over time.

deviceType(, ):
Deprecated
get/radar/http/timeseries_groups/device_type

Retrieves the distribution of HTTP requests by device type over time.

httpProtocol(, ):
Deprecated
get/radar/http/timeseries_groups/http_protocol

Retrieves the distribution of HTTP requests by HTTP protocol (HTTP vs. HTTPS) over time.

httpVersion(, ):
Deprecated
get/radar/http/timeseries_groups/http_version

Retrieves the distribution of HTTP requests by HTTP version over time.

ipVersion(, ):
Deprecated
get/radar/http/timeseries_groups/ip_version

Retrieves the distribution of HTTP requests by IP version over time.

os(, ):
Deprecated
get/radar/http/timeseries_groups/os

Retrieves the distribution of HTTP requests by operating system over time.

postQuantum(, ):
Deprecated
get/radar/http/timeseries_groups/post_quantum

Retrieves the distribution of HTTP requests by post-quantum support over time.

Radar.HTTP.Top

Methods

browser(, ):
Deprecated
get/radar/http/top/browser

Deprecated

Retrieves the top user agents by HTTP requests.

browserFamily(, ):
Deprecated
get/radar/http/top/browser_family

Deprecated

Retrieves the top user agents, aggregated in families, by HTTP requests.

Radar

Leaked Credentials

Radar.LeakedCredentials

Methods

summaryV2(, , ):
get/radar/leaked_credential_checks/summary/{dimension}

Retrieves an aggregated summary of HTTP authentication requests grouped by the specified dimension.

timeseriesGroupsV2(, , ):
get/radar/leaked_credential_checks/timeseries_groups/{dimension}

Retrieves the distribution of HTTP authentication requests, grouped by the specified dimension over time.

Radar.LeakedCredentials.Summary

Methods

botClass(, ):
Deprecated
get/radar/leaked_credential_checks/summary/bot_class

Retrieves the distribution of HTTP authentication requests by bot class.

compromised(, ):
Deprecated
get/radar/leaked_credential_checks/summary/compromised

Retrieves the distribution of HTTP authentication requests by compromised credential status.

RadarLeaked Credentials

Timeseries Groups

Radar.LeakedCredentials.TimeseriesGroups

Methods

botClass(, ):
Deprecated
get/radar/leaked_credential_checks/timeseries_groups/bot_class

Retrieves the distribution of HTTP authentication requests by bot class over time.

compromised(, ):
Deprecated
get/radar/leaked_credential_checks/timeseries_groups/compromised

Retrieves the distribution of HTTP authentication requests by compromised credential status over time.

Radar

Netflows

Radar.Netflows

Methods

timeseries(, ):
get/radar/netflows/timeseries

Retrieves network traffic (NetFlows) over time.

summary(, ):
Deprecated
get/radar/netflows/summary

Retrieves the distribution of network traffic (NetFlows) by HTTP vs other protocols.

summaryV2(, , ):
get/radar/netflows/summary/{dimension}

Retrieves the distribution of network traffic (NetFlows) by the specified dimension.

timeseriesGroups(, , ):
get/radar/netflows/timeseries_groups/{dimension}

Retrieves the distribution of NetFlows traffic, grouped by chosen the specified dimension over time.

Radar.Netflows.Top

Methods

ases(, ):
get/radar/netflows/top/ases

Retrieves the top autonomous systems by network traffic (NetFlows).

locations(, ):
get/radar/netflows/top/locations

Retrieves the top locations by network traffic (NetFlows).

Radar

Quality

Radar.Quality

Radar.Quality.IQI

Methods

summary(, ):
get/radar/quality/iqi/summary

Retrieves a summary (percentiles) of bandwidth, latency, or DNS response time from the Radar Internet Quality Index (IQI).

timeseriesGroups(, ):
get/radar/quality/iqi/timeseries_groups

Retrieves a time series (percentiles) of bandwidth, latency, or DNS response time from the Radar Internet Quality Index (IQI).

Radar.Quality.Speed

Methods

summary(, ):
get/radar/quality/speed/summary

Retrieves a summary of bandwidth, latency, jitter, and packet loss, from the previous 90 days of Cloudflare Speed Test data.

histogram(, ):
get/radar/quality/speed/histogram

Retrieves a histogram from the previous 90 days of Cloudflare Speed Test data, split into fixed bandwidth (Mbps), latency (ms), or jitter (ms) buckets.

Radar.Quality.Speed.Top

Methods

ases(, ):
get/radar/quality/speed/top/ases

Retrieves the top autonomous systems by bandwidth, latency, jitter, or packet loss, from the previous 90 days of Cloudflare Speed Test data.

locations(, ):
get/radar/quality/speed/top/locations

Retrieves the top locations by bandwidth, latency, jitter, or packet loss, from the previous 90 days of Cloudflare Speed Test data.

Radar

Ranking

Radar.Ranking

Methods

timeseriesGroups(, ):
get/radar/ranking/timeseries_groups

Retrieves domains rank over time.

top(, ):
get/radar/ranking/top

Retrieves the top or trending domains based on their rank. Popular domains are domains of broad appeal based on how people use the Internet. Trending domains are domains that are generating a surge in interest. For more information on top domains, see https://blog.cloudflare.com/radar-domain-rankings/.

Radar.Ranking.Domain

Methods

get(, , ):
get/radar/ranking/domain/{domain}

Retrieves domain rank details. Cloudflare provides an ordered rank for the top 100 domains, but for the remainder it only provides ranking buckets like top 200 thousand, top one million, etc.. These are available through Radar datasets endpoints.

RadarRanking

Internet Services

Radar.Ranking.InternetServices

Methods

timeseriesGroups(, ):
get/radar/ranking/internet_services/timeseries_groups

Retrieves Internet Services rank update changes over time.

top(, ):
get/radar/ranking/internet_services/top

Retrieves top Internet services based on their rank.

categories(, ):
get/radar/ranking/internet_services/categories

Retrieves the list of Internet services categories.

Radar

Robots TXT

Radar.RobotsTXT

Radar.RobotsTXT.Top

Methods

domainCategories(, ):
get/radar/robots_txt/top/domain_categories

Retrieves the top domain categories by the number of robots.txt files parsed.

Radar.RobotsTXT.Top.UserAgents

Methods

directive(, ):
get/radar/robots_txt/top/user_agents/directive

Retrieves the top user agents on robots.txt files.

Radar

Search

Radar.Search

Methods

global(, ):
get/radar/search/global

Searches for locations, autonomous systems, reports, bots, certificate logs, certificate authorities, industries and verticals

Radar

TCP Resets Timeouts

Radar.TCPResetsTimeouts

Methods

summary(, ):
get/radar/tcp_resets_timeouts/summary

Retrieves the distribution of connection stage by TCP connections terminated within the first 10 packets by a reset or timeout.

timeseriesGroups(, ):
get/radar/tcp_resets_timeouts/timeseries_groups

Retrieves the distribution of connection stage by TCP connections terminated within the first 10 packets by a reset or timeout over time.

Radar

Traffic Anomalies

Radar.TrafficAnomalies

Methods

get(, ):
get/radar/traffic_anomalies

Retrieves the latest Internet traffic anomalies, which are signals that might indicate an outage. These alerts are automatically detected by Radar and manually verified by our team.

Radar.TrafficAnomalies.Locations

Methods

get(, ):
get/radar/traffic_anomalies/locations

Retrieves the sum of Internet traffic anomalies, grouped by location. These anomalies are signals that might indicate an outage, automatically detected by Radar and manually verified by our team.

Radar

Verified Bots

Radar.VerifiedBots

Radar.VerifiedBots.Top

Methods

bots(, ):
Deprecated
get/radar/verified_bots/top/bots

Deprecated

Use Radar Bots API instead.

Retrieves the top verified bots by HTTP requests, with owner and category.

categories(, ):
Deprecated
get/radar/verified_bots/top/categories

Deprecated

Use Radar Bots API instead.

Retrieves the top verified bot categories by HTTP requests, along with their corresponding percentage, over the total verified bot HTTP requests.