---
title: "Get Bots"
method: POST
path: "/v1/logs/raw/bots"
tags: ["Agent Analytics"]
deprecated: true
---

# Get Bots

`POST /v1/logs/raw/bots`

> **Deprecated.**

Get identified bot logs with filters

## Request body

- BotsQuery
  - `date_interval` 'hour' | 'day' | 'week' | 'month' | 'year' | 'relative_week' — Date interval for the report. (only used with date dimension)
  - `dimensions` union[] — Dimensions to group the report by.
    - union
      - 'timestamp' | 'method' | 'host' | 'path' | 'status_code' | 'ip' | 'user_agent' | 'referer' | 'bytes_sent' | 'duration_ms' | 'query_params'
      - 'bot_name' | 'bot_provider' | 'bot_types'
  - `metrics` string[], required
  - `order_by` object — Custom ordering of the report results. The order is a record of key-value pairs where: - key is the field to order by, which can be a metric or dimension - value is the direction of the order, either 'asc' for ascending or 'desc' for descending. When not specified, the default order is the first metric in the query descending.
  - `pagination` Pagination — Offset-based pagination parameters.
    - `limit` integer — Maximum number of results to return. Default is 10,000, maximum is 50,000.
    - `offset` integer — Offset for the results. Used for pagination.
  - `domain` string, required — Domain to query logs for.
  - `start_date` string, date-time, required — Start date for logs. Accepts: YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DD HH:MM:SS, or full ISO timestamp.
  - `end_date` string, date-time — End date for logs. Accepts same formats as start_date. Defaults to now if omitted.
  - `organization_id` string, uuid, nullable
  - `filters` union[] — List of filters to apply to the bots logs query.
    - union
      - BotNameFilter — Filter by bot name (user agent)
        - `field` 'bot_name', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - 'Amazonbot' | 'ClaudeBot' | 'Claude-User' | 'Claude-SearchBot' | 'Applebot' | 'Applebot-Extended' | 'Bytespider' | 'DeepSeek' | 'DuckAssistBot' | 'DuckDuckBot' | 'Googlebot' | 'Googlebot-News' | 'Googlebot-Video' | 'Googlebot-Image' | 'Google-Extended' | 'Storebot-Google' | 'Google-CloudVertexBot' | 'meta-externalfetcher' | 'meta-externalagent' | 'bingbot' | 'MicrosoftPreview' | 'ChatGPT-User' | 'GPTBot' | 'OAI-SearchBot' | 'OAI-Operator' | 'PerplexityBot' | 'Perplexity-User' | 'Grok-PageBrowser' | 'YouBot' | 'OpenClaw' | 'baiduspider' | 'CCBot' | 'ERNIEBot' | 'Gemini-Fetch' | 'YandexBot' | 'PetalBot' | 'MistralAI-User' | 'Slurp' | 'Gemini-Deep-Research'
          - string[]
      - BotProviderFilter — Filter by bot provider
        - `field` 'bot_provider', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - 'openai' | 'anthropic' | 'chatgpt' | 'deepseek' | 'google' | 'microsoft' | 'perplexity' | 'apple' | 'bytedance' | 'amazon' | 'meta' | 'duckduckgo' | 'you' | 'xai' | 'grok' | 'gemini' | 'mistral' | 'huawei' | 'yandex' | 'baidu' | 'yahoo' | 'commoncrawl' | 'openclaw'
          - string[]
      - BotTypesFilter — Filter by bot types (ai_assistant, ai_training, or index)
        - `field` 'bot_types', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - 'ai_assistant' | 'ai_training' | 'index'
          - string[]
      - MethodFilter — Filter by HTTP method
        - `field` 'method', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - PathFilter — Filter by request path
        - `field` 'path', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - StatusCodeFilter — Filter by HTTP status code
        - `field` 'status_code', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - integer
          - integer[]
      - IpFilter — Filter by IP address
        - `field` 'ip', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - UserAgentFilter — Filter by user agent
        - `field` 'user_agent', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - RefererFilter — Filter by referer
        - `field` 'referer', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - QueryParamsFilter — Filter by query parameters
        - `field` 'query_params', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]

## Response `200`

Successful Response

- union
  - LogVisitBot[]
    - `timestamp` string, date-time, required
    - `org_id` string, uuid, required
    - `method` string, required
    - `host` string, required
    - `path` string, required
    - `status_code` integer, required
    - `ip` string, required
    - `user_agent` string, required
    - `referer` string
    - `bytes_sent` integer
    - `duration_ms` integer
    - `query_params` object
    - `bot_name` string, required
    - `bot_provider` string, required
    - `bot_types` string[], required
  - Response — Base response model for reports.
    - `info` Info, required — Base model for report information.
      - `total_rows` integer, required
      - `query` object, nullable
    - `data` Result[], required
      - `metrics` union[], required
        - union
          - integer
          - number
      - `dimensions` union[], required
        - union
          - string
          - string, uuid

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/cooper-square-technologies/apis/external-api.md) · [All operations](https://skmtc.net/cooper-square-technologies/apis/external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cooper-square-technologies/external-api/versions/ab03b3c80494/schema)