Get a directory bot's daily unique visitors

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

Authorization

AuthorizationBearer token · headerrequired

Request body

requiredapplication/json

daysinteger<int64>

Days to return, today included.

min 1 · max 90 · default: 30

idstringrequired

The bot's public id.

Responses

200

dailyBotStatsDay[]required

One entry per day, oldest first, today last. A day with no visitors has zeros.

Show properties

Array of BotStatsDay

clickinteger<int64>required

min 0

daystring<date>required

The UTC day.

listinteger<int64>required

min 0

pageinteger<int64>required

min 0

planinteger<int64>required

min 0

totalsBotStatsCountsrequired

Unique visitors over the whole range. A visitor who came on several days counts once, so this is not the sum of the days.

Show properties

clickinteger<int64>required

Unique visitors who clicked through to the bot's Steam profile or trade link.

min 0

listinteger<int64>required

Unique visitors who had the bot's row on screen in the directory.

min 0

pageinteger<int64>required

Unique visitors who opened the bot's page.

min 0

planinteger<int64>required

Unique signed-in visitors whose calculator plan included the bot.

min 0

401

Unauthorized

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

404

Not Found

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

422

Unprocessable Entity

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

500

Internal Server Error

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

daysintegerDays to return, today included.idstring*The bot's public id.

Request

curl -X POST 'https://api.steamsets.com/v1/bot.stats' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "days": 30,
  "id": "bot_3cVFAKxh8Q2ZqkTq"
}'

const response = await fetch("https://api.steamsets.com/v1/bot.stats", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"days\": 30,\n  \"id\": \"bot_3cVFAKxh8Q2ZqkTq\"\n}"
});

import requests

response = requests.post(
    "https://api.steamsets.com/v1/bot.stats",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"days\": 30,\n  \"id\": \"bot_3cVFAKxh8Q2ZqkTq\"\n}",
)

Response

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

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}