Get bot details

radar.bots.get(, ) -> BotGetResponse

GET/radar/bots/{bot_slug}

Retrieves the requested bot information.

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 WriteUser Details Read

ParametersExpand Collapse

bot_slug: str

Bot slug.

maxLength100

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

Format in which results will be returned.

One of the following:

"JSON"

"CSV"

ReturnsExpand Collapse

class BotGetResponse: …

bot: 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.

operator_url: str

The link to the bot documentation.

slug: str

A kebab-case identifier derived from the bot name.

user_agent_patterns: List[str]

user_agents: List[str]

Get bot details

import os
from cloudflare import Cloudflare

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

{
  "result": {
    "bot": {
      "category": "AI_CRAWLER",
      "description": "OpenAI/ChatGPT's web crawler",
      "kind": "AGENT",
      "name": "GPTBot",
      "operator": "OpenAI",
      "operatorUrl": "https://platform.openai.com/docs/bots",
      "slug": "gptbot",
      "userAgentPatterns": [
        "GPTBot"
      ],
      "userAgents": [
        "GPTBot"
      ]
    }
  },
  "success": true
}

Returns Examples

{
  "result": {
    "bot": {
      "category": "AI_CRAWLER",
      "description": "OpenAI/ChatGPT's web crawler",
      "kind": "AGENT",
      "name": "GPTBot",
      "operator": "OpenAI",
      "operatorUrl": "https://platform.openai.com/docs/bots",
      "slug": "gptbot",
      "userAgentPatterns": [
        "GPTBot"
      ],
      "userAgents": [
        "GPTBot"
      ]
    }
  },
  "success": true
}