---
search:
  tags:
    - Bots
    - POST
seo:
  description: >-
    Feeds the bot owner's stats (bot.stats). Send it from the browser after
    hydration, never… Reference for the POST /v1/bot.track endpoint in the
    SteamSets API.
sidebar:
  label: Record directory bots a visitor saw, opened or clicked through to
  badge: POST
title: Record directory bots a visitor saw, opened or clicked through to
type: openapi-operation
---
Feeds the bot owner's stats (bot.stats). Send it from the browser after hydration, never from the server render. Unknown bot ids are ignored, and the response is always empty.

`POST /v1/bot.track`

**Request body** (`application/json`, required)

- `events` (BotTrackEvent[], required) — Up to 200 events. A repeat of the same bot and kind counts once.

Request body example:

```json
{
  "events": [
    {
      "botId": "bot_3cVFAKxh8Q2ZqkTq",
      "kind": "list"
    }
  ]
}
```

**Responses**

- `204` — No Content
- `400` — Bad Request
- `422` — Unprocessable Entity
- `500` — Internal Server Error