Record directory bots a visitor saw, opened or clicked through to

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

Authorization

AuthorizationBearer token · headerrequired

Request body

requiredapplication/json

eventsBotTrackEvent[]required

Up to 200 events. A repeat of the same bot and kind counts once.

max items 200

Show properties

Array of BotTrackEvent

botIdstringrequired

The bot's public id. An id no listed bot has is ignored.

max length 32

kindstringrequired

list: the bot's row was on screen in the directory. page: its page was opened. click: a click through to its Steam profile or trade link.

Allowed:listpageclick

Responses

204

No Content

400

Bad Request

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

Request body

Request

curl -X POST 'https://api.steamsets.com/v1/bot.track' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/problem+json' \
  -H 'Content-Type: application/json' \
  -d '{
  "events": [
    {
      "botId": "bot_3cVFAKxh8Q2ZqkTq",
      "kind": "list"
    }
  ]
}'

const response = await fetch("https://api.steamsets.com/v1/bot.track", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/problem+json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"events\": [\n    {\n      \"botId\": \"bot_3cVFAKxh8Q2ZqkTq\",\n      \"kind\": \"list\"\n    }\n  ]\n}"
});

import requests

response = requests.post(
    "https://api.steamsets.com/v1/bot.track",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/problem+json",
        "Content-Type": "application/json"
    },
    data="{\n  \"events\": [\n    {\n      \"botId\": \"bot_3cVFAKxh8Q2ZqkTq\",\n      \"kind\": \"list\"\n    }\n  ]\n}",
)

Response

No Content

{
  "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"
}