---
search:
  tags:
    - Bots
    - POST
seo:
  description: >-
    Unique visitors per UTC day who saw the bot in the directory, opened its
    page, got it in… Reference for the POST /v1/bot.stats endpoint in the
    SteamSets API.
sidebar:
  label: Get a directory bot's daily unique visitors
  badge: POST
title: Get a directory bot's daily unique visitors
type: openapi-operation
---
Unique visitors per UTC day who saw the bot in the directory, opened its page, got it in a calculator plan and clicked through to Steam. For the bot's owner and staff; anyone else gets 404.

`POST /v1/bot.stats`

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

- `days` (integer<int64>) — Days to return, today included.
- `id` (string, required) — The bot's public id.

Request body example:

```json
{
  "days": 30,
  "id": "bot_3cVFAKxh8Q2ZqkTq"
}
```

**Responses**

- `200` — OK
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

Response example, 200:

```json
{
  "daily": [
    {
      "click": 0,
      "day": "2026-11-11",
      "list": 0,
      "page": 0,
      "plan": 0
    }
  ],
  "totals": {
    "click": 0,
    "list": 0,
    "page": 0,
    "plan": 0
  }
}
```
