Sign in

v4

latestOpenAPI 3.1.02026-07-3196251302.5 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)

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.

trackedOwnersinteger required

Owners steamsets tracks for this app

Example response

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