v4

OpenAPI 3.1.02026-07-3196251302.5 KB

badge

List accounts that own a badge (earliest completion first). Donator perk — page size scales with Patreon tier.

post/v1/badge.listCrafters

Request body

$schemastring uri

A URL to the JSON Schema for this object.

badgeIdstring required

Badge id

cursorstring

Opaque pagination cursor from the previous page's nextCursor. Omit for the first page.

limitinteger

Page size (capped by donator tier)

Example request

{
  "$schema": "https://api.steamsets.com/schemas/BadgeListCraftersRequestBody.json"
}

Response

$schemastring uri

A URL to the JSON Schema for this object.

maxPageSizeinteger required

Largest page size your donator tier allows

nextCursorstring

Pass as cursor to fetch the next page. Absent when there are no more crafters.

trackedHoldersinteger required

Holders steamsets tracks for this badge

Example response

{
  "$schema": "https://api.steamsets.com/schemas/BadgeListCraftersResponseBody.json",
  "crafters": [
    {
      "appCost": 123456,
      "apps": 123456,
      "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
      "awardsGiven": 123456,
      "awardsReceived": 123456,
      "badges": 123456,
      "city": {
        "name": "Bad Krozingen"
      },
      "country": {
        "code": "DE",
        "name": "Germany"
      },
      "createdAt": "2023-01-01T00:00:00Z",
      "donated": 123456,
      "economyBan": "steam",
      "foilBadgeCost": 123456,
      "foilBadges": 123456,
      "friends": 123456,
      "level": 123456,
      "name": "steamsets",
      "normalBadgeCost": 123456,
      "normalBadges": 123456,
      "playtime": 123456,
      "pointsGiven": 123456,
      "pointsReceived": 123456,
      "privacy": "public",
      "region": {
        "name": "Europe"
      },
      "state": {
        "name": "Baden-Wurttemberg"
      },
      "steamId": "76561198842603734",
      "steamSetsVanity": "steamsets",
      "steamVanity": "steamsets",
      "xp": 123456
    }
  ]
}