Sign in

v6

OpenAPI 3.1.02026-08-0597255315.1 KB
item

Find owners of one or more trading cards or booster packs. Friend paths from the requester are included for logged-in callers.

post/v1/item.findOwners

Request body

$schemastring uri

A URL to the JSON Schema for this object.

cursorstring

Opaque pagination cursor from the previous page's nextCursor. Pages to any depth at constant cost, and requires exactly one entry in itemIds. Omit for the first page.

itemIdsinteger[] nullable required

Trading item class IDs to look up

maxDepthinteger

Friend-path depth limit (default 4, max 6); ignored when not logged in

offsetinteger

Number of owners to skip per item, for pagination. Random access, but only one item at a time past owner 100 and never past 10000 — use cursor to page deeper.

ownersPerIteminteger

Page size, max owners returned per item (default 10, max 25)

Example request

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

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://api.steamsets.com/schemas/FindOwnersResponseBody.json",
  "items": [
    {
      "owners": [
        {
          "account": {
            "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
          },
          "path": [
            {
              "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
            }
          ]
        }
      ]
    }
  ]
}