## List bots

`radar.bots.list(BotListParams**kwargs)  -> BotListResponse`

**get** `/radar/bots`

Retrieves a list of bots.

### Parameters

- `bot_category: Optional[Literal["SEARCH_ENGINE_CRAWLER", "SEARCH_ENGINE_OPTIMIZATION", "MONITORING_AND_ANALYTICS", 13 more]]`

  Filters results by bot category.

  - `"SEARCH_ENGINE_CRAWLER"`

  - `"SEARCH_ENGINE_OPTIMIZATION"`

  - `"MONITORING_AND_ANALYTICS"`

  - `"ADVERTISING_AND_MARKETING"`

  - `"SOCIAL_MEDIA_MARKETING"`

  - `"PAGE_PREVIEW"`

  - `"ACADEMIC_RESEARCH"`

  - `"SECURITY"`

  - `"ACCESSIBILITY"`

  - `"WEBHOOKS"`

  - `"FEED_FETCHER"`

  - `"AI_CRAWLER"`

  - `"AGGREGATOR"`

  - `"AI_ASSISTANT"`

  - `"AI_SEARCH"`

  - `"ARCHIVER"`

- `bot_operator: Optional[str]`

  Filters results by bot operator.

- `bot_verification_status: Optional[Literal["VERIFIED"]]`

  Filters results by bot verification status.

  - `"VERIFIED"`

- `format: Optional[Literal["JSON", "CSV"]]`

  Format in which results will be returned.

  - `"JSON"`

  - `"CSV"`

- `kind: Optional[Literal["AGENT", "BOT"]]`

  Filters results by bot kind.

  - `"AGENT"`

  - `"BOT"`

- `limit: Optional[int]`

  Limits the number of objects returned in the response.

- `offset: Optional[int]`

  Skips the specified number of objects before fetching the results.

### Returns

- `class BotListResponse: …`

  - `bots: List[Bot]`

    - `category: str`

      The category of the bot.

    - `description: str`

      A summary for the bot (e.g., purpose).

    - `kind: str`

      The kind of the bot.

    - `name: str`

      The name of the bot.

    - `operator: str`

      The organization that owns and operates the bot.

    - `slug: str`

      A kebab-case identifier derived from the bot name.

    - `user_agent_patterns: List[str]`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
bots = client.radar.bots.list()
print(bots.bots)
```

#### Response

```json
{
  "result": {
    "bots": [
      {
        "category": "AI_CRAWLER",
        "description": "OpenAI/ChatGPT's web crawler",
        "kind": "AGENT",
        "name": "GPTBot",
        "operator": "OpenAI",
        "slug": "gptbot",
        "userAgentPatterns": [
          "GPTBot"
        ]
      }
    ]
  },
  "success": true
}
```