---
title: Verified Bots
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/typescript)

[Radar](https://developers.cloudflare.com/api/typescript/resources/radar)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Verified Bots

#### Verified BotsTop

##### [Get top verified bots by HTTP requests](https://developers.cloudflare.com/api/typescript/resources/radar/subresources/verified%5Fbots/subresources/top/methods/bots)

Deprecated

client.radar.verifiedBots.top.bots(TopBotsParams { asn, continent, dateEnd, 6 more } query?, RequestOptionsoptions?): [TopBotsResponse](https://developers.cloudflare.com/api/typescript/resources/radar#%28resource%29%20radar.verified%5Fbots.top%20%3E%20%28model%29%20top%5Fbots%5Fresponse%20%3E%20%28schema%29) { meta, top\_0 } 

GET/radar/verified\_bots/top/bots

##### [Get top verified bot categories by HTTP requests](https://developers.cloudflare.com/api/typescript/resources/radar/subresources/verified%5Fbots/subresources/top/methods/categories)

Deprecated

client.radar.verifiedBots.top.categories(TopCategoriesParams { asn, continent, dateEnd, 6 more } query?, RequestOptionsoptions?): [TopCategoriesResponse](https://developers.cloudflare.com/api/typescript/resources/radar#%28resource%29%20radar.verified%5Fbots.top%20%3E%20%28model%29%20top%5Fcategories%5Fresponse%20%3E%20%28schema%29) { meta, top\_0 } 

GET/radar/verified\_bots/top/categories

##### ModelsExpand Collapse 

TopBotsResponse { meta, top\_0 } 

meta: Meta { confidenceInfo, dateRange, lastUpdated, 2 more } 

Metadata for the results.

confidenceInfo: ConfidenceInfo | null

annotations: Array<Annotation\>

dataSource: "ALL" | "AI\_BOTS" | "AI\_GATEWAY" | 22 more

Data source for annotations.

One of the following:

"ALL"

"AI\_BOTS"

"AI\_GATEWAY"

"BGP"

"BOTS"

"CONNECTION\_ANOMALY"

"CT"

"DNS"

"DNS\_MAGNITUDE"

"DNS\_AS112"

"DOS"

"EMAIL\_ROUTING"

"EMAIL\_SECURITY"

"FW"

"FW\_PG"

"HTTP"

"HTTP\_CONTROL"

"HTTP\_CRAWLER\_REFERER"

"HTTP\_ORIGINS"

"IQI"

"LEAKED\_CREDENTIALS"

"NET"

"ROBOTS\_TXT"

"SPEED"

"WORKERS\_AI"

description: string

endDate: string

formatdate-time

eventType: "GENERAL" | "OUTAGE" | "PARTIAL\_PROJECTION" | 2 more

Event type for annotations.

One of the following:

"GENERAL"

"OUTAGE"

"PARTIAL\_PROJECTION"

"PIPELINE"

"TRAFFIC\_ANOMALY"

isInstantaneous: boolean

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

linkedUrl: string

formaturi

startDate: string

formatdate-time

tags?: Array<string\>

level: number

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

dateRange: Array<DateRange\>

endTime: string

Adjusted end of date range.

formatdate-time

startTime: string

Adjusted start of date range.

formatdate-time

lastUpdated: string

Timestamp of the last dataset update.

formatdate-time

normalization: "PERCENTAGE" | "MIN0\_MAX" | "MIN\_MAX" | 5 more

Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

One of the following:

"PERCENTAGE"

"MIN0\_MAX"

"MIN\_MAX"

"RAW\_VALUES"

"PERCENTAGE\_CHANGE"

"ROLLING\_AVERAGE"

"OVERLAPPED\_PERCENTAGE"

"RATIO"

units: Array<Unit\>

Measurement units for the results.

name: string

value: string

top\_0: Array<Top0\>

botCategory: string

botName: string

botOwner: string

value: string

A numeric string.

TopCategoriesResponse { meta, top\_0 } 

meta: Meta { confidenceInfo, dateRange, lastUpdated, 2 more } 

Metadata for the results.

confidenceInfo: ConfidenceInfo | null

annotations: Array<Annotation\>

dataSource: "ALL" | "AI\_BOTS" | "AI\_GATEWAY" | 22 more

Data source for annotations.

One of the following:

"ALL"

"AI\_BOTS"

"AI\_GATEWAY"

"BGP"

"BOTS"

"CONNECTION\_ANOMALY"

"CT"

"DNS"

"DNS\_MAGNITUDE"

"DNS\_AS112"

"DOS"

"EMAIL\_ROUTING"

"EMAIL\_SECURITY"

"FW"

"FW\_PG"

"HTTP"

"HTTP\_CONTROL"

"HTTP\_CRAWLER\_REFERER"

"HTTP\_ORIGINS"

"IQI"

"LEAKED\_CREDENTIALS"

"NET"

"ROBOTS\_TXT"

"SPEED"

"WORKERS\_AI"

description: string

endDate: string

formatdate-time

eventType: "GENERAL" | "OUTAGE" | "PARTIAL\_PROJECTION" | 2 more

Event type for annotations.

One of the following:

"GENERAL"

"OUTAGE"

"PARTIAL\_PROJECTION"

"PIPELINE"

"TRAFFIC\_ANOMALY"

isInstantaneous: boolean

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

linkedUrl: string

formaturi

startDate: string

formatdate-time

tags?: Array<string\>

level: number

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

dateRange: Array<DateRange\>

endTime: string

Adjusted end of date range.

formatdate-time

startTime: string

Adjusted start of date range.

formatdate-time

lastUpdated: string

Timestamp of the last dataset update.

formatdate-time

normalization: "PERCENTAGE" | "MIN0\_MAX" | "MIN\_MAX" | 5 more

Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

One of the following:

"PERCENTAGE"

"MIN0\_MAX"

"MIN\_MAX"

"RAW\_VALUES"

"PERCENTAGE\_CHANGE"

"ROLLING\_AVERAGE"

"OVERLAPPED\_PERCENTAGE"

"RATIO"

units: Array<Unit\>

Measurement units for the results.

name: string

value: string

top\_0: Array<Top0\>

botCategory: string

value: string

A numeric string.