Sign in
OpenAPI 3.1.02026-08-1098258320.3 KB

84c030d12df1

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)

pageinteger

1-based page to jump to. Use this or cursor, not both. Reaches at most 100000 crafters deep; walk with cursor past that.

Example request

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

Response

OK

$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.

pageinteger required

1-based page this response holds

pageSizeinteger required

Crafters per page used for this response

totalPagesinteger required

Pages available at this page size, capped at the deepest page a page jump can reach

trackedHoldersinteger required

Holders steamsets tracks for this badge

Example response

{
  "$schema": "https://api.steamsets.com/schemas/BadgeListCraftersResponseBody.json",
  "crafters": [
    {
      "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",
      "foilBadges": 123456,
      "friends": 123456,
      "level": 123456,
      "name": "steamsets",
      "nameEffect": "rainbow",
      "normalBadges": 123456,
      "playtime": 123456,
      "pointsGiven": 123456,
      "pointsReceived": 123456,
      "privacy": "public",
      "region": {
        "name": "Europe"
      },
      "state": {
        "name": "Baden-Wurttemberg"
      },
      "steamId": "76561198842603734",
      "steamSetsVanity": "steamsets",
      "steamVanity": "steamsets",
      "themeColor": "#FF5733",
      "xp": 123456
    }
  ]
}