Skip to content
SteamSets
Esc
↑↓navigate↵open⌘Jpreview

List the bots in the bot directory

GET/v1/bot.list
Authorization
AuthorizationBearer token · headerrequired
Responses
200

OK

botsBotListEntry[]required
Show properties
Array of BotListEntry
appsinteger<int32>required

Distinct apps with stock.

min 0
avatarUrlstringrequired
brandIdinteger<int32>required

The operator this bot belongs to, an id in brands. 0 for none.

min 0
buySetsPerKeynumber<float>required

Sets the bot wants for one of its TF2 keys. 0 when it does not buy.

foilSetsinteger<int32>required

Complete foil sets in stock.

min 0
idinteger<int32>required
min 0
maxLevelinteger<int64>required

Highest Steam level reachable from level 0 with this bot alone.

maxSetsPerAppinteger<int32>required

Most sets of one app sold to one user. 0 means no limit.

min 0
namestringrequired
normalSetsinteger<int32>required

Complete normal sets in stock.

min 0
onlinebooleanrequired
ownerBotListOwner

The Steam account that runs the bot. Missing when no one has claimed it.

Show properties
avatarUrlstringrequired
namestringrequired

Empty when Steamsets has not seen the account yet.

steamIdstringrequired
sellSetsPerKeynumber<float>required

Sets the bot sells for one TF2 key. 0 when it does not sell or has not told us.

setsForYouinteger<int64>

Sets this bot alone can sell the logged-in caller, given the badges they have crafted. Missing when logged out.

sourcestringrequired

push: the bot reports its own stock. scrape: we count it from the bot's inventory.

Allowed:pushscrape
stalebooleanrequired

The bot has not reported for over an hour.

steamIdstringrequired
updatedAtstring<date-time>required

When the bot last reported or was scraped.

brandsBotListBrand[]required

Brands with at least one listed bot: sponsored first, in display order, then the rest by name.

Show properties
Array of BotListBrand
idinteger<int32>required
min 0
logoUrlstringrequired
namestringrequired
sponsoredbooleanrequired

Shown as its own section at the top.

websiteUrlstringrequired
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
Authorization
Request
curl -X GET 'https://api.steamsets.com/v1/bot.list' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "bots": [
    {
      "apps": 0,
      "avatarUrl": "string",
      "brandId": 0,
      "buySetsPerKey": 0.1,
      "foilSets": 0,
      "id": 0,
      "maxLevel": 0,
      "maxSetsPerApp": 0,
      "name": "string",
      "normalSets": 0,
      "online": true,
      "owner": {
        "avatarUrl": "string",
        "name": "string",
        "steamId": "string"
      },
      "sellSetsPerKey": 0.1,
      "setsForYou": 0,
      "source": "push",
      "stale": true,
      "steamId": "76561199756787903",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "brands": [
    {
      "id": 0,
      "logoUrl": "string",
      "name": "string",
      "sponsored": true,
      "websiteUrl": "string"
    }
  ]
}