--- title: Bots --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Radar](https://developers.cloudflare.com/api/python/resources/radar) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Bots ##### [List bots](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/methods/list) radar.bots.list(BotListParams\*\*kwargs) -> [BotListResponse]() GET/radar/bots ##### [Get bot details](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/methods/get) radar.bots.get(strbot\_slug, BotGetParams\*\*kwargs) -> [BotGetResponse]() GET/radar/bots/{bot\_slug} ##### [Get bots HTTP requests distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/methods/summary) radar.bots.summary(Literal\["BOT", "BOT\_KIND", "BOT\_OPERATOR", "BOT\_CATEGORY"]dimension, BotSummaryParams\*\*kwargs) -> [BotSummaryResponse]() GET/radar/bots/summary/{dimension} ##### [Get bots HTTP requests time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/methods/timeseries) radar.bots.timeseries(BotTimeseriesParams\*\*kwargs) -> [BotTimeseriesResponse]() GET/radar/bots/timeseries ##### [Get time series distribution of bots HTTP requests by dimension.](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/methods/timeseries_groups) radar.bots.timeseries\_groups(Literal\["BOT", "BOT\_KIND", "BOT\_OPERATOR", "BOT\_CATEGORY"]dimension, BotTimeseriesGroupsParams\*\*kwargs) -> [BotTimeseriesGroupsResponse]() GET/radar/bots/timeseries\_groups/{dimension} ##### ModelsExpand Collapse
class BotListResponse: …
bots: List\[Bot] category: str The category of the bot. Link to this property description: str A summary for the bot (e.g., purpose). Link to this property Deprecatedkind: str The kind of the bot. Link to this property name: str The name of the bot. Link to this property operator: str The organization that owns and operates the bot. Link to this property slug: str A kebab-case identifier derived from the bot name. Link to this property user\_agent\_patterns: List\[str] Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20bot_list_response%20%3E%20(schema)>)
class BotGetResponse: …
bot: Bot category: str The category of the bot. Link to this property description: str A summary for the bot (e.g., purpose). Link to this property Deprecatedkind: str The kind of the bot. Link to this property name: str The name of the bot. Link to this property operator: str The organization that owns and operates the bot. Link to this property operator\_url: str The link to the bot documentation. Link to this property slug: str A kebab-case identifier derived from the bot name. Link to this property user\_agent\_patterns: List\[str] Link to this property user\_agents: List\[str] Link to this property signature\_agent\_url: Optional\[str] The URL of the agent’s Web Bot Auth resource. Null for bots not verified via request signature. Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20bot_get_response%20%3E%20(schema)>)
class BotSummaryResponse: …
meta: Meta Metadata for the results.
confidence\_info: MetaConfidenceInfo
annotations: List\[MetaConfidenceInfoAnnotation]
data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations. One of the following: "ALL" Link to this property "AI\_BOTS" Link to this property "AI\_GATEWAY" Link to this property "BGP" Link to this property "BOTS" Link to this property "CONNECTION\_ANOMALY" Link to this property "CT" Link to this property "DNS" Link to this property "DNS\_MAGNITUDE" Link to this property "DNS\_AS112" Link to this property "DOS" Link to this property "EMAIL\_ROUTING" Link to this property "EMAIL\_SECURITY" Link to this property "FW" Link to this property "FW\_PG" Link to this property "HTTP" Link to this property "HTTP\_CONTROL" Link to this property "HTTP\_CRAWLER\_REFERER" Link to this property "HTTP\_ORIGINS" Link to this property "IQI" Link to this property "LEAKED\_CREDENTIALS" Link to this property "NET" Link to this property "ROBOTS\_TXT" Link to this property "SPEED" Link to this property "WORKERS\_AI" Link to this property
Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property
event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations. One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property
Link to this property is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property
Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
date\_range: List\[MetaDateRange] end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property
Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property
normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods. One of the following: "PERCENTAGE" Link to this property "MIN0\_MAX" Link to this property "MIN\_MAX" Link to this property "RAW\_VALUES" Link to this property "PERCENTAGE\_CHANGE" Link to this property "ROLLING\_AVERAGE" Link to this property "OVERLAPPED\_PERCENTAGE" Link to this property "RATIO" Link to this property
Link to this property
units: List\[MetaUnit] Measurement units for the results. name: str Link to this property value: str Link to this property
Link to this property
Link to this property summary\_0: Dict\[str, str] Link to this property
[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20bot_summary_response%20%3E%20(schema)>)
class BotTimeseriesResponse: …
meta: Meta Metadata for the results.
agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals. One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property
Link to this property
confidence\_info: MetaConfidenceInfo
annotations: List\[MetaConfidenceInfoAnnotation]
data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations. One of the following: "ALL" Link to this property "AI\_BOTS" Link to this property "AI\_GATEWAY" Link to this property "BGP" Link to this property "BOTS" Link to this property "CONNECTION\_ANOMALY" Link to this property "CT" Link to this property "DNS" Link to this property "DNS\_MAGNITUDE" Link to this property "DNS\_AS112" Link to this property "DOS" Link to this property "EMAIL\_ROUTING" Link to this property "EMAIL\_SECURITY" Link to this property "FW" Link to this property "FW\_PG" Link to this property "HTTP" Link to this property "HTTP\_CONTROL" Link to this property "HTTP\_CRAWLER\_REFERER" Link to this property "HTTP\_ORIGINS" Link to this property "IQI" Link to this property "LEAKED\_CREDENTIALS" Link to this property "NET" Link to this property "ROBOTS\_TXT" Link to this property "SPEED" Link to this property "WORKERS\_AI" Link to this property
Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property
event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations. One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property
Link to this property is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property
Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
date\_range: List\[MetaDateRange] end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property
Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property
normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods. One of the following: "PERCENTAGE" Link to this property "MIN0\_MAX" Link to this property "MIN\_MAX" Link to this property "RAW\_VALUES" Link to this property "PERCENTAGE\_CHANGE" Link to this property "ROLLING\_AVERAGE" Link to this property "OVERLAPPED\_PERCENTAGE" Link to this property "RATIO" Link to this property
Link to this property
units: List\[MetaUnit] Measurement units for the results. name: str Link to this property value: str Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20bot_timeseries_response%20%3E%20(schema)>)
class BotTimeseriesGroupsResponse: …
meta: Meta Metadata for the results.
agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals. One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property
Link to this property
confidence\_info: MetaConfidenceInfo
annotations: List\[MetaConfidenceInfoAnnotation]
data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations. One of the following: "ALL" Link to this property "AI\_BOTS" Link to this property "AI\_GATEWAY" Link to this property "BGP" Link to this property "BOTS" Link to this property "CONNECTION\_ANOMALY" Link to this property "CT" Link to this property "DNS" Link to this property "DNS\_MAGNITUDE" Link to this property "DNS\_AS112" Link to this property "DOS" Link to this property "EMAIL\_ROUTING" Link to this property "EMAIL\_SECURITY" Link to this property "FW" Link to this property "FW\_PG" Link to this property "HTTP" Link to this property "HTTP\_CONTROL" Link to this property "HTTP\_CRAWLER\_REFERER" Link to this property "HTTP\_ORIGINS" Link to this property "IQI" Link to this property "LEAKED\_CREDENTIALS" Link to this property "NET" Link to this property "ROBOTS\_TXT" Link to this property "SPEED" Link to this property "WORKERS\_AI" Link to this property
Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property
event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations. One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property
Link to this property is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property
Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
date\_range: List\[MetaDateRange] end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property
Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property
normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods. One of the following: "PERCENTAGE" Link to this property "MIN0\_MAX" Link to this property "MIN\_MAX" Link to this property "RAW\_VALUES" Link to this property "PERCENTAGE\_CHANGE" Link to this property "ROLLING\_AVERAGE" Link to this property "OVERLAPPED\_PERCENTAGE" Link to this property "RATIO" Link to this property
Link to this property
units: List\[MetaUnit] Measurement units for the results. name: str Link to this property value: str Link to this property
Link to this property
Link to this property
serie\_0: Serie0 timestamps: List\[datetime] Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20bot_timeseries_groups_response%20%3E%20(schema)>) #### BotsWeb Crawlers ##### [Get crawler HTTP request distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/subresources/web_crawlers/methods/summary) radar.bots.web\_crawlers.summary(Literal\["CLIENT\_TYPE", "USER\_AGENT", "REFERER", 5 more]dimension, WebCrawlerSummaryParams\*\*kwargs) -> [WebCrawlerSummaryResponse]() GET/radar/bots/crawlers/summary/{dimension} ##### [Get time series of crawler HTTP request distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/bots/subresources/web_crawlers/methods/timeseries_groups) radar.bots.web\_crawlers.timeseries\_groups(Literal\["CLIENT\_TYPE", "USER\_AGENT", "REFERER", 5 more]dimension, WebCrawlerTimeseriesGroupsParams\*\*kwargs) -> [WebCrawlerTimeseriesGroupsResponse]() GET/radar/bots/crawlers/timeseries\_groups/{dimension} ##### ModelsExpand Collapse
class WebCrawlerSummaryResponse: …
meta: Meta Metadata for the results.
confidence\_info: MetaConfidenceInfo
annotations: List\[MetaConfidenceInfoAnnotation]
data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations. One of the following: "ALL" Link to this property "AI\_BOTS" Link to this property "AI\_GATEWAY" Link to this property "BGP" Link to this property "BOTS" Link to this property "CONNECTION\_ANOMALY" Link to this property "CT" Link to this property "DNS" Link to this property "DNS\_MAGNITUDE" Link to this property "DNS\_AS112" Link to this property "DOS" Link to this property "EMAIL\_ROUTING" Link to this property "EMAIL\_SECURITY" Link to this property "FW" Link to this property "FW\_PG" Link to this property "HTTP" Link to this property "HTTP\_CONTROL" Link to this property "HTTP\_CRAWLER\_REFERER" Link to this property "HTTP\_ORIGINS" Link to this property "IQI" Link to this property "LEAKED\_CREDENTIALS" Link to this property "NET" Link to this property "ROBOTS\_TXT" Link to this property "SPEED" Link to this property "WORKERS\_AI" Link to this property
Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property
event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations. One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property
Link to this property is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property
Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
date\_range: List\[MetaDateRange] end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property
Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property
normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods. One of the following: "PERCENTAGE" Link to this property "MIN0\_MAX" Link to this property "MIN\_MAX" Link to this property "RAW\_VALUES" Link to this property "PERCENTAGE\_CHANGE" Link to this property "ROLLING\_AVERAGE" Link to this property "OVERLAPPED\_PERCENTAGE" Link to this property "RATIO" Link to this property
Link to this property
units: List\[MetaUnit] Measurement units for the results. name: str Link to this property value: str Link to this property
Link to this property
Link to this property summary\_0: Dict\[str, str] Link to this property
[Link to this property](<#(resource)%20radar.bots.web_crawlers%20%3E%20(model)%20web_crawler_summary_response%20%3E%20(schema)>)
class WebCrawlerTimeseriesGroupsResponse: …
meta: Meta Metadata for the results.
agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals. One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property
Link to this property
confidence\_info: MetaConfidenceInfo
annotations: List\[MetaConfidenceInfoAnnotation]
data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations. One of the following: "ALL" Link to this property "AI\_BOTS" Link to this property "AI\_GATEWAY" Link to this property "BGP" Link to this property "BOTS" Link to this property "CONNECTION\_ANOMALY" Link to this property "CT" Link to this property "DNS" Link to this property "DNS\_MAGNITUDE" Link to this property "DNS\_AS112" Link to this property "DOS" Link to this property "EMAIL\_ROUTING" Link to this property "EMAIL\_SECURITY" Link to this property "FW" Link to this property "FW\_PG" Link to this property "HTTP" Link to this property "HTTP\_CONTROL" Link to this property "HTTP\_CRAWLER\_REFERER" Link to this property "HTTP\_ORIGINS" Link to this property "IQI" Link to this property "LEAKED\_CREDENTIALS" Link to this property "NET" Link to this property "ROBOTS\_TXT" Link to this property "SPEED" Link to this property "WORKERS\_AI" Link to this property
Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property
event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations. One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property
Link to this property is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property
Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
date\_range: List\[MetaDateRange] end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property
Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property
normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods. One of the following: "PERCENTAGE" Link to this property "MIN0\_MAX" Link to this property "MIN\_MAX" Link to this property "RAW\_VALUES" Link to this property "PERCENTAGE\_CHANGE" Link to this property "ROLLING\_AVERAGE" Link to this property "OVERLAPPED\_PERCENTAGE" Link to this property "RATIO" Link to this property
Link to this property
units: List\[MetaUnit] Measurement units for the results. name: str Link to this property value: str Link to this property
Link to this property
Link to this property
serie\_0: Serie0 timestamps: List\[datetime] Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.bots.web_crawlers%20%3E%20(model)%20web_crawler_timeseries_groups_response%20%3E%20(schema)>)