Sign in

v4

OpenAPI 3.1.02026-07-3196251302.5 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.

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

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": {
            "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
          },
          "path": [
            {
              "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
            }
          ]
        }
      ]
    }
  ]
}