--- title: List bots --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Radar](https://developers.cloudflare.com/api/go/resources/radar) [Bots](https://developers.cloudflare.com/api/go/resources/radar/subresources/bots) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List bots client.Radar.Bots.List(ctx, query) (\*[BotListResponse](), error) GET/radar/bots Retrieves a list of bots. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `User Details Write``User Details Read` ##### ParametersExpand Collapse
query BotListParams
BotCategory param.Field\[BotListParamsBotCategory]Optional Filters results by bot category. const BotListParamsBotCategorySearchEngineCrawler BotListParamsBotCategory = "SEARCH\_ENGINE\_CRAWLER" Link to this property const BotListParamsBotCategorySearchEngineOptimization BotListParamsBotCategory = "SEARCH\_ENGINE\_OPTIMIZATION" Link to this property const BotListParamsBotCategoryMonitoringAndAnalytics BotListParamsBotCategory = "MONITORING\_AND\_ANALYTICS" Link to this property const BotListParamsBotCategoryAdvertisingAndMarketing BotListParamsBotCategory = "ADVERTISING\_AND\_MARKETING" Link to this property const BotListParamsBotCategorySocialMediaMarketing BotListParamsBotCategory = "SOCIAL\_MEDIA\_MARKETING" Link to this property const BotListParamsBotCategoryPagePreview BotListParamsBotCategory = "PAGE\_PREVIEW" Link to this property const BotListParamsBotCategoryAcademicResearch BotListParamsBotCategory = "ACADEMIC\_RESEARCH" Link to this property const BotListParamsBotCategorySecurity BotListParamsBotCategory = "SECURITY" Link to this property const BotListParamsBotCategoryAccessibility BotListParamsBotCategory = "ACCESSIBILITY" Link to this property const BotListParamsBotCategoryWebhooks BotListParamsBotCategory = "WEBHOOKS" Link to this property const BotListParamsBotCategoryFeedFetcher BotListParamsBotCategory = "FEED\_FETCHER" Link to this property const BotListParamsBotCategoryAICrawler BotListParamsBotCategory = "AI\_CRAWLER" Link to this property const BotListParamsBotCategoryAggregator BotListParamsBotCategory = "AGGREGATOR" Link to this property const BotListParamsBotCategoryAIAssistant BotListParamsBotCategory = "AI\_ASSISTANT" Link to this property const BotListParamsBotCategoryAISearch BotListParamsBotCategory = "AI\_SEARCH" Link to this property const BotListParamsBotCategoryArchiver BotListParamsBotCategory = "ARCHIVER" Link to this property
Link to this property BotOperator param.Field\[string]Optional Filters results by bot operator. maxLength100 Link to this property
BotVerificationStatus param.Field\[BotListParamsBotVerificationStatus]Optional Filters results by bot verification status. const BotListParamsBotVerificationStatusVerified BotListParamsBotVerificationStatus = "VERIFIED" Link to this property
Link to this property
Format param.Field\[BotListParamsFormat]Optional Format in which results will be returned. const BotListParamsFormatJson BotListParamsFormat = "JSON" Link to this property const BotListParamsFormatCsv BotListParamsFormat = "CSV" Link to this property
Link to this property
Kind param.Field\[BotListParamsKind]Optional Filters results by bot kind. Deprecated: the Verified Bot / Signed Agent distinction is being removed. const BotListParamsKindAgent BotListParamsKind = "AGENT" Link to this property const BotListParamsKindBot BotListParamsKind = "BOT" Link to this property
Link to this property Limit param.Field\[int64]Optional Limits the number of objects returned in the response. exclusiveMinimum minimum0 Link to this property Offset param.Field\[int64]Optional Skips the specified number of objects before fetching the results. minimum0 Link to this property
[Link to this property](<#(resource)%20radar.bots%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type BotListResponse struct{…}
Bots \[]BotListResponseBot Category string The category of the bot. Link to this property Description string A summary for the bot (e.g., purpose). Link to this property DeprecatedKind string The kind of the bot. Link to this property Name string The name of the bot. Link to this property Operator string The organization that owns and operates the bot. Link to this property Slug string A kebab-case identifier derived from the bot name. Link to this property UserAgentPatterns \[]string Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.bots%20%3E%20(model)%20BotListResponse%20%3E%20(schema)>) ### List bots Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/radar" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) bots, err := client.Radar.Bots.List(context.TODO(), radar.BotListParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", bots.Bots) } ``` 200 example ``` { "result": { "bots": [ { "category": "AI_CRAWLER", "description": "OpenAI/ChatGPT's web crawler", "kind": "AGENT", "name": "GPTBot", "operator": "OpenAI", "slug": "gptbot", "userAgentPatterns": [ "GPTBot" ] } ] }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": { "bots": [ { "category": "AI_CRAWLER", "description": "OpenAI/ChatGPT's web crawler", "kind": "AGENT", "name": "GPTBot", "operator": "OpenAI", "slug": "gptbot", "userAgentPatterns": [ "GPTBot" ] } ] }, "success": true } ```