Radar

radar

radar.ai

radar.ai.bots

radar.ai.bots.summary

Methods

Get AI User Agents Summary -> Envelope<{ meta, summary_0 }>
get/radar/ai/bots/summary/user_agent

Retrieves the distribution of traffic by AI user agent.

RadarAI

Inference

radar.ai.inference

radar.ai.inference.summary

Methods

Get Workers AI Models Summary -> Envelope<{ meta, summary_0 }>
get/radar/ai/inference/summary/model

Retrieves the distribution of unique accounts by model.

Get Workers AI Tasks Summary -> Envelope<{ meta, summary_0 }>
get/radar/ai/inference/summary/task

Retrieves the distribution of unique accounts by task.

RadarAIInference

Timeseries Groups

radar.ai.inference.timeseries_groups

radar.ai.inference.timeseries_groups.summary

Methods

Get Workers AI Models Time Series -> Envelope<{ meta, serie_0 }>
get/radar/ai/inference/timeseries_groups/model

Retrieves the distribution of unique accounts by model over time.

Get Workers AI Tasks Time Series -> Envelope<{ meta, serie_0 }>
get/radar/ai/inference/timeseries_groups/task

Retrieves the distribution of unique accounts by task over time.

RadarAI

Timeseries Groups

radar.ai.timeseries_groups

Methods

Get AI User Agents Time Series -> Envelope<{ meta, serie_0 }>
get/radar/ai/bots/timeseries_groups/user_agent

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

Radar

Annotations

radar.annotations

Methods

Get Latest Annotations -> Envelope<{ annotations }>
get/radar/annotations

Retrieves the latest annotations.

radar.annotations.outages

Methods

Get Latest Internet Outages And Anomalies -> Envelope<{ annotations }>
get/radar/annotations/outages

Retrieves the latest Internet outages and anomalies.

Get The Number Of Outages By Location -> Envelope<{ annotations }>
get/radar/annotations/outages/locations

Retrieves the number of outages by location.

Radar

AS112

radar.as112

Methods

Get AS112 DNS Queries Time Series -> Envelope<{ meta, serie_0 }>
get/radar/as112/timeseries

Retrieves the AS112 DNS queries over time.

RadarAS112

Summary

radar.as112.summary

Methods

Get AS112 DNS Queries By DNSSEC Summary -> Envelope<{ meta, summary_0 }>
get/radar/as112/summary/dnssec

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

Get AS112 DNS Queries By Edns Summary -> Envelope<{ meta, summary_0 }>
get/radar/as112/summary/edns

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

Get AS112 DNS Queries By IP Version Summary -> Envelope<{ meta, summary_0 }>
get/radar/as112/summary/ip_version

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

Get AS112 DNS Queries By DNS Protocol Summary -> Envelope<{ meta, summary_0 }>
get/radar/as112/summary/protocol

Retrieves the distribution of DNS queries to AS112 by protocol.

Get AS112 DNS Queries By Type Summary -> Envelope<{ meta, summary_0 }>
get/radar/as112/summary/query_type

Retrieves the distribution of DNS queries to AS112 by type.

Get AS112 DNS Queries By Response Code Summary -> Envelope<{ meta, summary_0 }>
get/radar/as112/summary/response_codes

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

RadarAS112

Timeseries Groups

radar.as112.timeseries_groups

Methods

Get AS112 DNS Queries By DNSSEC Support Time Series -> Envelope<{ meta, serie_0 }>
get/radar/as112/timeseries_groups/dnssec

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

Get AS112 DNS Queries By Edns Support Summary -> Envelope<{ meta, serie_0 }>
get/radar/as112/timeseries_groups/edns

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

Get AS112 DNS Queries By IP Version Time Series -> Envelope<{ meta, serie_0 }>
get/radar/as112/timeseries_groups/ip_version

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

Get AS112 DNS Queries By DNS Protocol Time Series -> Envelope<{ meta, serie_0 }>
get/radar/as112/timeseries_groups/protocol

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

Get AS112 DNS Queries By Type Time Series -> Envelope<{ meta, serie_0 }>
get/radar/as112/timeseries_groups/query_type

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

Get AS112 DNS Queries By Response Code Time Series -> Envelope<{ meta, serie_0 }>
get/radar/as112/timeseries_groups/response_codes

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

radar.as112.top

Methods

Get Top Locations By AS112 DNS Queries With DNSSEC Support -> Envelope<{ meta, top_0 }>
get/radar/as112/top/locations/dnssec/{dnssec}

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

Get Top Locations By AS112 DNS Queries With Edns Support -> Envelope<{ meta, top_0 }>
get/radar/as112/top/locations/edns/{edns}

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

Get Top Locations By AS112 DNS Queries For An IP Version -> Envelope<{ meta, top_0 }>
get/radar/as112/top/locations/ip_version/{ip_version}

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

Get Top Locations By AS112 DNS Queries -> Envelope<{ meta, top_0 }>
get/radar/as112/top/locations

Retrieves the top locations by AS112 DNS queries.

Radar

Attacks

radar.attacks

radar.attacks.layer3

Methods

Get Layer 3 Attacks By Bytes Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer3/timeseries

Retrieves layer 3 attacks over time.

radar.attacks.layer3.summary

Methods

Get Layer 3 Attacks By Bitrate Summary -> Envelope<{ meta, summary_0 }>
get/radar/attacks/layer3/summary/bitrate

Retrieves the distribution of layer 3 attacks by bitrate.

Get Layer 3 Attacks By Duration Summary -> Envelope<{ meta, summary_0 }>
get/radar/attacks/layer3/summary/duration

Retrieves the distribution of layer 3 attacks by duration.

Get Layer 3 Attacks By IP Version Summary -> Envelope<{ meta, summary_0 }>
get/radar/attacks/layer3/summary/ip_version

Retrieves the distribution of layer 3 attacks by IP version.

Get Layer 3 Attacks By Protocol Summary -> Envelope<{ meta, summary_0 }>
get/radar/attacks/layer3/summary/protocol

Retrieves the distribution of layer 3 attacks by protocol.

Get Layer 3 Attacks By Vector Summary -> Envelope<{ meta, summary_0 }>
get/radar/attacks/layer3/summary/vector

Retrieves the distribution of layer 3 attacks by vector.

RadarAttacksLayer3

Timeseries Groups

radar.attacks.layer3.timeseries_groups

Methods

Get Layer 3 Attacks By Bitrate Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer3/timeseries_groups/bitrate

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

Get Layer 3 Attacks By Duration Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer3/timeseries_groups/duration

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

Get Layer 3 Attacks By Target Industries Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer3/timeseries_groups/industry

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

Get Layer 3 Attacks By IP Version Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer3/timeseries_groups/ip_version

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

Get Layer 3 Attacks By Protocol Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer3/timeseries_groups/protocol

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

Get Layer 3 Attacks By Vector Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer3/timeseries_groups/vector

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

Get Layer 3 Attacks By Vertical Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer3/timeseries_groups/vertical

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

radar.attacks.layer3.top

Methods

Get Top Layer 3 Attack Pairs Origin And Target Locations -> Envelope<{ meta, top_0 }>
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).

Get Top Industries Targeted By Layer 3 Attacks -> Envelope<{ meta, top_0 }>
get/radar/attacks/layer3/top/industry

Retrieves the top industries targeted by layer 3 attacks.

Get Top Verticals Targeted By Layer 3 Attacks -> Envelope<{ meta, top_0 }>
get/radar/attacks/layer3/top/vertical

Retrieves the top verticals targeted by layer 3 attacks.

radar.attacks.layer3.top.locations

Methods

Get Top Origin Locations Of Layer 3 Attacks -> Envelope<{ meta, top_0 }>
get/radar/attacks/layer3/top/locations/origin

Retrieves the origin locations of layer 3 attacks.

Get Top Target Locations Of Layer 3 Attacks -> Envelope<{ meta, top_0 }>
get/radar/attacks/layer3/top/locations/target

Retrieves the target locations of layer 3 attacks.

radar.attacks.layer7

Methods

Get Layer 7 Attacks Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer7/timeseries

Retrieves layer 7 attacks over time.

radar.attacks.layer7.summary

Methods

Get Layer 7 Attacks By HTTP Method Summary -> Envelope<{ meta, summary_0 }>
get/radar/attacks/layer7/summary/http_method

Retrieves the distribution of layer 7 attacks by HTTP method.

Get Layer 7 Attacks By HTTP Version Summary -> Envelope<{ meta, summary_0 }>
get/radar/attacks/layer7/summary/http_version

Retrieves the distribution of layer 7 attacks by HTTP version.

Get Layer 7 Attacks By IP Version Summary -> Envelope<{ meta, summary_0 }>
get/radar/attacks/layer7/summary/ip_version

Retrieves the distribution of layer 7 attacks by IP version.

Get Layer 7 Attacks By Managed Rules Summary -> Envelope<{ meta, summary_0 }>
get/radar/attacks/layer7/summary/managed_rules

Retrieves the distribution of layer 7 attacks by managed rules.

Get Layer 7 Attacks By Mitigation Product Summary -> Envelope<{ meta, summary_0 }>
get/radar/attacks/layer7/summary/mitigation_product

Retrieves the distribution of layer 7 attacks by mitigation product.

RadarAttacksLayer7

Timeseries Groups

radar.attacks.layer7.timeseries_groups

Methods

Get Layer 7 Attacks By HTTP Method Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer7/timeseries_groups/http_method

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

Get Layer 7 Attacks By HTTP Version Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer7/timeseries_groups/http_version

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

Get Layer 7 Attacks By Target Industries Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer7/timeseries_groups/industry

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

Get Layer 7 Attacks By IP Version Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer7/timeseries_groups/ip_version

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

Get Layer 7 Attacks By Managed Rules Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer7/timeseries_groups/managed_rules

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

Get Layer 7 Attacks By Mitigation Product Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer7/timeseries_groups/mitigation_product

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

Get Layer 7 Attacks By Vertical Time Series -> Envelope<{ meta, serie_0 }>
get/radar/attacks/layer7/timeseries_groups/vertical

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

radar.attacks.layer7.top

Methods

Get Top Layer 7 Attack Pairs Origin And Target Locations -> Envelope<{ meta, top_0 }>
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).

Get Top Industries Targeted By Layer 7 Attacks -> Envelope<{ meta, top_0 }>
get/radar/attacks/layer7/top/industry

Retrieves the industries targeted by layer 7 attacks.

Get Top Verticals Targeted By Layer 7 Attacks -> Envelope<{ meta, top_0 }>
get/radar/attacks/layer7/top/vertical

Retrieves the verticals targeted by layer 7 attacks.

radar.attacks.layer7.top.ases

Methods

Get Top Origin A Ses Of Layer 7 Attacks -> Envelope<{ meta, top_0 }>
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

Get Top Origin Locations Of Layer 7 Attacks -> Envelope<{ meta, top_0 }>
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.

Get Top Target Locations Of Layer 7 Attacks -> Envelope<{ meta, top_0 }>
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

Get BGP Time Series -> Envelope<{ meta, serie_0 }>
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

Get BGP Hijack Events -> V4PagePagination<{ asn_info, events, total_monitors }>
get/radar/bgp/hijacks/events

Retrieves the BGP hijack events.

radar.bgp.ips

Methods

Get Announced IP Address Space Time Series -> Envelope<{ meta, serie_174 }>
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

Get BGP Route Leak Events -> V4PagePagination<{ asn_info, events }>
get/radar/bgp/leaks/events

Retrieves the BGP route leak events.

RadarBGP

Routes

radar.bgp.routes

Methods

List A Ses From Global Routing Tables -> Envelope<{ asns, meta }>
get/radar/bgp/routes/ases

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

Get Multi Origin As Moas Prefixes -> Envelope<{ meta, moas }>
get/radar/bgp/routes/moas

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

Get Prefix To ASN Mapping -> Envelope<{ meta, prefix_origins }>
get/radar/bgp/routes/pfx2as

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

Security

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

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

User Details Write User Details Read

Parameters
format:
Optional

Format in which results will be returned.

"JSON"
"CSV"
longestPrefixMatch: boolean
Optional

Return only results with the longest prefix match for the given prefix. For example, specify a /32 prefix to lookup the origin ASN for an IPv4 address.

origin: number
Optional

Lookup prefixes originated by the given ASN.

prefix: string
Optional

Network prefix, IPv4 or IPv6.

rpkiStatus:
Optional

Return only results with matching rpki status: valid, invalid or unknown.

"VALID"
"INVALID"
"UNKNOWN"
Response fields
result: { meta, prefix_origins }
success: boolean
Request example
200Example
Get BGP Routing Table Stats -> Envelope<{ meta, stats }>
get/radar/bgp/routes/stats

Retrieves the BGP routing table stats.

radar.bgp.top

Methods

Get Top Prefixes By BGP Updates -> Envelope<{ meta, top_0 }>
get/radar/bgp/top/prefixes

Retrieves the top network prefixes by BGP updates.

radar.bgp.top.ases

Methods

Get Top A Ses By BGP Updates -> Envelope<{ meta, top_0 }>
get/radar/bgp/top/ases

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

Get Top A Ses By Prefix Count -> Envelope<{ asns, meta }>
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

Datasets

radar.datasets

Methods

Get Dataset Download URL -> Envelope<{ dataset }>
post/radar/datasets/download

Retrieves an URL to download a single dataset.

Get Dataset Csv Stream -> string
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.

List Datasets -> Envelope<{ datasets }>
get/radar/datasets

Retrieves a list of datasets.

radar.dns

radar.dns.top

Methods

Get Top A Ses By DNS Queries -> Envelope<{ meta, top_0 }>
get/radar/dns/top/ases

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

Get Top Locations By DNS Queries -> Envelope<{ meta, top_0 }>
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 = { FAIL, NONE, PASS }
RadarEmailSummary = { FAIL, NONE, PASS }
RadarEmail

Routing

radar.email.routing

radar.email.routing.summary

Methods

Get Email ARC Validation Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/routing/summary/arc

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

Get Email DKIM Validation Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/routing/summary/dkim

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

Get Email DMARC Validation Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/routing/summary/dmarc

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

Get Email Encryption Status Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/routing/summary/encrypted

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

Get Email IP Version Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/routing/summary/ip_version

Retrieves the distribution of emails by IP version.

Get Email SPF Validation Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/routing/summary/spf

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

RadarEmailRouting

Timeseries Groups

radar.email.routing.timeseries_groups

Methods

Get Email ARC Validation Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/routing/timeseries_groups/arc

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

Get Email DKIM Validation Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/routing/timeseries_groups/dkim

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

Get Email DMARC Validation Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/routing/timeseries_groups/dmarc

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

Get Email Encryption Status Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/routing/timeseries_groups/encrypted

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

Get Email IP Version Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/routing/timeseries_groups/ip_version

Retrieves the distribution of emails by IP version over time.

Get Email SPF Validation Time Series -> Envelope<{ meta, serie_0 }>
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

radar.email.security.summary

Methods

Get Email ARC Validation Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/security/summary/arc

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

Get Email DKIM Validation Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/security/summary/dkim

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

Get Email DMARC Validation Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/security/summary/dmarc

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

Get Email Malicious Classification Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/security/summary/malicious

Retrieves the distribution of emails by malicious classification.

Get Email Spam Classification Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/security/summary/spam

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

Get Email SPF Validation Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/security/summary/spf

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

Get Email Spoof Classification Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/security/summary/spoof

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

Get Email Threat Category Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/security/summary/threat_category

Retrieves the distribution of emails by threat categories.

Get Email TLS Version Summary -> Envelope<{ meta, summary_0 }>
get/radar/email/security/summary/tls_version

Retrieves the distribution of emails by TLS version.

RadarEmailSecurity

Timeseries Groups

radar.email.security.timeseries_groups

Methods

Get Email ARC Validation Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/security/timeseries_groups/arc

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

Get Email DKIM Validation Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/security/timeseries_groups/dkim

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

Get Email DMARC Validation Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/security/timeseries_groups/dmarc

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

Get Email Malicious Classification Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/security/timeseries_groups/malicious

Retrieves the distribution of emails by malicious classification over time.

Get Email Spam Classification Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/security/timeseries_groups/spam

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

Get Email SPF Validation Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/security/timeseries_groups/spf

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

Get Email Spoof Classification Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/security/timeseries_groups/spoof

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

Get Email Threat Category Time Series -> Envelope<{ meta, serie_0 }>
get/radar/email/security/timeseries_groups/threat_category

Retrieves the distribution of emails by threat category over time.

Get Email TLS Version Time Series -> Envelope<{ meta, serie_0 }>
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 Top Tl DS By Email Message Volume -> Envelope<{ meta, top_0 }>
get/radar/email/security/top/tlds

Retrieves the top TLDs by number of email messages.

radar.email.security.top.tlds.malicious

Methods

Get Top Tl DS By Email Malicious Classification -> Envelope<{ meta, top_0 }>
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 Top Tl DS By Email Spam Classification -> Envelope<{ meta, top_0 }>
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 Top Tl DS By Email Spoof Classification -> Envelope<{ meta, top_0 }>
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 IP Address Details -> Envelope<{ ip }>
get/radar/entities/ip

Retrieves IP address information.

radar.entities.asns

Methods

Get As Details By ASN -> Envelope<{ asn }>
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).

Get As Details By IP Address -> Envelope<{ asn }>
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).

List Autonomous Systems -> Envelope<{ asns }>
get/radar/entities/asns

Retrieves a list of autonomous systems.

Get As Level Relationships By ASN -> Envelope<{ meta, rels }>
get/radar/entities/asns/{asn}/rel

Retrieves AS-level relationship for given networks.

RadarEntities

Locations

radar.entities.locations

Methods

Get Location Details -> Envelope<{ location }>
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).

List Locations -> Envelope<{ locations }>
get/radar/entities/locations

Retrieves a list of locations.

Radar

HTTP

radar.http

Methods

Get HTTP Requests Time Series -> Envelope<{ meta, serie_0 }>
get/radar/http/timeseries

Retrieves the HTTP requests over time.

radar.http.ases

Methods

Get Top A Ses By HTTP Requests -> Envelope<{ meta, top_0 }>
get/radar/http/top/ases

Retrieves the top autonomous systems by HTTP requests.

RadarHTTPAses

Bot Class

radar.http.ases.bot_class

Methods

Get Top A Ses By HTTP Requests For A Bot Class -> Envelope<{ meta, top_0 }>
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.browser_family

Methods

Get Top A Ses By HTTP Requests For A Browser Family -> Envelope<{ meta, top_0 }>
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.device_type

Methods

Get Top A Ses By HTTP Requests For A Device Type -> Envelope<{ meta, top_0 }>
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.http_method

Methods

Get Top A Ses By HTTP Requests For An HTTP Version -> Envelope<{ meta, top_0 }>
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.http_protocol

Methods

Get Top A Ses By HTTP Requests For An HTTP Protocol -> Envelope<{ meta, top_0 }>
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.ip_version

Methods

Get Top A Ses By HTTP Requests For An IP Version -> Envelope<{ meta, top_0 }>
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 Top A Ses By HTTP Requests For An OS -> Envelope<{ meta, top_0 }>
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.tls_version

Methods

Get Top A Ses By HTTP Requests For A TLS Version -> Envelope<{ meta, top_0 }>
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 Top Locations By HTTP Requests -> Envelope<{ meta, top_0 }>
get/radar/http/top/locations

Retrieves the top locations by HTTP requests.

radar.http.locations.bot_class

Methods

Get Top Locations By HTTP Requests For A Bot Class -> Envelope<{ meta, top_0 }>
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.browser_family

Methods

Get Top Locations By HTTP Requests For A Browser Family -> Envelope<{ meta, top_0 }>
get/radar/http/top/locations/browser_family/{browser_family}

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

radar.http.locations.device_type

Methods

Get Top Locations By HTTP Requests For A Device Type -> Envelope<{ meta, top_0 }>
get/radar/http/top/locations/device_type/{device_type}

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

radar.http.locations.http_method

Methods

Get Top Locations By HTTP Requests For An HTTP Version -> Envelope<{ meta, top_0 }>
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.http_protocol

Methods

Get Top Locations By HTTP Requests For An HTTP Protocol -> Envelope<{ meta, top_0 }>
get/radar/http/top/locations/http_protocol/{http_protocol}

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

radar.http.locations.ip_version

Methods

Get Top Locations By HTTP Requests For An IP Version -> Envelope<{ meta, top_0 }>
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 Top Locations By HTTP Requests For An OS -> Envelope<{ meta, top_0 }>
get/radar/http/top/locations/os/{os}

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

radar.http.locations.tls_version

Methods

Get Top Locations By HTTP Requests For A TLS Version -> Envelope<{ meta, top_0 }>
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

Get HTTP Requests By Bot Class Summary -> Envelope<{ meta, summary_0 }>
get/radar/http/summary/bot_class

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.

Get HTTP Requests By Device Type Summary -> Envelope<{ meta, summary_0 }>
get/radar/http/summary/device_type

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

Get HTTP Requests By HTTP HTTPS Summary -> Envelope<{ meta, summary_0 }>
get/radar/http/summary/http_protocol

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

Get HTTP Requests By HTTP Version Summary -> Envelope<{ meta, summary_0 }>
get/radar/http/summary/http_version

Retrieves the distribution of HTTP requests by HTTP version.

Get HTTP Requests By IP Version Summary -> Envelope<{ meta, summary_0 }>
get/radar/http/summary/ip_version

Retrieves the distribution of HTTP requests by IP version.

Get HTTP Requests By OS Summary -> Envelope<{ meta, summary_0 }>
get/radar/http/summary/os

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

Get HTTP Requests By Post Quantum Support Summary -> Envelope<{ meta, summary_0 }>
get/radar/http/summary/post_quantum

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

Get HTTP Requests By TLS Version Summary -> Envelope<{ meta, summary_0 }>
get/radar/http/summary/tls_version

Retrieves the distribution of HTTP requests by TLS version.

RadarHTTP

Timeseries Groups

radar.http.timeseries_groups

Methods

Get HTTP Requests By Bot Class Time Series -> Envelope<{ meta, serie_0 }>
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.

Get HTTP Requests By User Agent Time Series -> Envelope<{ meta, serie_0 }>
get/radar/http/timeseries_groups/browser

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

Get HTTP Requests By User Agent Family Time Series -> Envelope<{ meta, serie_0 }>
get/radar/http/timeseries_groups/browser_family

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

Get HTTP Requests By Device Type Time Series -> Envelope<{ meta, serie_0 }>
get/radar/http/timeseries_groups/device_type

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

Get HTTP Requests By HTTP HTTPS Time Series -> Envelope<{ meta, serie_0 }>
get/radar/http/timeseries_groups/http_protocol

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

Get HTTP Requests By HTTP Version Time Series -> Envelope<{ meta, serie_0 }>
get/radar/http/timeseries_groups/http_version

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

Get HTTP Requests By IP Version Time Series -> Envelope<{ meta, serie_0 }>
get/radar/http/timeseries_groups/ip_version

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

Get HTTP Requests By OS Time Series -> Envelope<{ meta, serie_0 }>
get/radar/http/timeseries_groups/os

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

Get HTTP Requests By Post Quantum Support Time Series -> Envelope<{ meta, serie_0 }>
get/radar/http/timeseries_groups/post_quantum

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

Get HTTP Requests By TLS Version Time Series -> Envelope<{ meta, serie_0 }>
get/radar/http/timeseries_groups/tls_version

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

radar.http.top

Methods

Get Top User Agents By HTTP Requests -> Envelope<{ meta, top_0 }>
get/radar/http/top/browser

Retrieves the top user agents by HTTP requests.

Get Top User Agent Families By HTTP Requests -> Envelope<{ meta, top_0 }>
get/radar/http/top/browser_family

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

Radar

Netflows

radar.netflows

Methods

Get Network Traffic Summary -> Envelope<{ meta, summary_0 }>
get/radar/netflows/summary

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

Get Network Traffic Time Series -> Envelope<{ meta, serie_0 }>
get/radar/netflows/timeseries

Retrieves network traffic (NetFlows) over time.

radar.netflows.top

Methods

Get Top A Ses By Network Traffic -> Envelope<{ top_0 }>
get/radar/netflows/top/ases

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

Get Top Locations By Network Traffic -> Envelope<{ top_0 }>
get/radar/netflows/top/locations

Retrieves the top locations by network traffic (NetFlows).

Radar

Quality

radar.quality

radar.quality.iqi

Methods

Get Internet Quality Index IQI Summary -> Envelope<{ meta, summary_0 }>
get/radar/quality/iqi/summary

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

Get Internet Quality Index IQI Time Series -> Envelope<{ meta, serie_0 }>
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

Get Speed Tests Histogram -> Envelope<{ histogram_0, meta }>
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.

Get Speed Tests Summary -> Envelope<{ meta, summary_0 }>
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.

radar.quality.speed.top

Methods

Get Top A Ses By Speed Test Results -> Envelope<{ meta, top_0 }>
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.

Get Top Locations By Speed Test Results -> Envelope<{ meta, top_0 }>
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

Get Domains Rank Time Series -> Envelope<{ meta, serie_0 }>
get/radar/ranking/timeseries_groups

Retrieves domains rank over time.

Get Top Or Trending Domains -> Envelope<{ meta, top_0 }>
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 Domain Rank Details -> Envelope<{ details_0, meta }>
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.internet_services

Methods

Get Internet Services Rank Time Series -> Envelope<{ meta, serie_0 }>
get/radar/ranking/internet_services/timeseries_groups

Retrieves Internet Services rank update changes over time.

Get Top Internet Services -> Envelope<{ meta, top_0 }>
get/radar/ranking/internet_services/top

Retrieves top Internet services based on their rank.

Radar

Robots TXT

radar.robots_txt

radar.robots_txt.top

Methods

Get Top Domain Categories By Robots TXT Files Parsed -> Envelope<{ meta, top_0 }>
get/radar/robots_txt/top/domain_categories

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

radar.robots_txt.top.user_agents

Methods

Get Top User Agents On Robots TXT Files -> Envelope<{ meta, top_0 }>
get/radar/robots_txt/top/user_agents/directive

Retrieves the top user agents on robots.txt files.

Radar

Search

radar.search

Methods

Search For Locations A Ses And Reports -> Envelope<{ search }>
get/radar/search/global

Searches for locations, autonomous systems, and reports.

Radar

TCP Resets Timeouts

radar.tcp_resets_timeouts

Methods

Get TCP Resets And Timeouts Summary -> Envelope<{ meta, summary_0 }>
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.

Get TCP Resets And Timeouts Time Series -> Envelope<{ meta, serie_0 }>
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.traffic_anomalies

Methods

Get Latest Internet Traffic Anomalies -> Envelope<{ trafficAnomalies }>
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.traffic_anomalies.locations

Methods

Get Top Locations By Total Traffic Anomalies -> Envelope<{ trafficAnomalies }>
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.verified_bots

radar.verified_bots.top

Methods

Get Top Verified Bots By HTTP Requests -> Envelope<{ meta, top_0 }>
get/radar/verified_bots/top/bots

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

Get Top Verified Bot Categories By HTTP Requests -> Envelope<{ meta, top_0 }>
get/radar/verified_bots/top/categories

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