Sign in

84c030d12df1

latestOpenAPI 3.1.02026-08-1098258320.3 KB
app

List accounts that own an app (highest playtime first). Donator perk — page size scales with Patreon tier.

post/v1/app.listOwners

Request body

$schemastring uri

A URL to the JSON Schema for this object.

appIdinteger required

App 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 owners deep; walk with cursor past that.

Example request

{
  "$schema": "https://api.steamsets.com/schemas/AppListOwnersRequestBody.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 owners.

pageinteger required

1-based page this response holds

pageSizeinteger required

Owners per page used for this response

totalPagesinteger required

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

trackedOwnersinteger required

Owners steamsets tracks for this app

Example response

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