Get account data points for charts

POST/v1/account.getDataPoints

Authorization

AuthorizationBearer token · headerrequired

Request body

requiredapplication/json

idIDSearch

Show properties

accountIdinteger<int32>

Account ID to search for

min 0 · min length 7

steamId64string

SteamID64 to search for

min length 17 · max length 17

vanityVanitySearch

Show properties

typestringrequired

Which type of vanity to search for

Allowed:steaminternal

valuestringrequired

Vanity to search for

min length 2 · matches ^[a-zA-Z0-9-_]+$

Responses

200

mostXpV1AppBadge[] | nullrequired

Show properties

Array of V1AppBadge

accountInfoAccountBadgeInfo | null

Show properties

completionTimestring<date-time>required

The time the badge was completed

levelinteger<int32>required

The level of the badge

min 0

xpinteger<int32>required

The xp of the badge

min 0

appIdinteger<int32>required

min 0

appImagestringrequired

appNamestringrequired

badgeIdstringrequired

badgeImagestringrequired

baseLevelinteger<int32>required

The level this badge starts at

min 0

baseXpinteger<int32>required

The XP the badge gives per level

min 0

cardCountinteger<int32>required

Total trading cards Steam defines for this app (per side; foil and normal share the same count)

min 0

firstCompletionstring<date-time> | nullrequired

highestLevelinteger<int64>required

isEventbooleanrequired

isFoilbooleanrequired

isNmcbooleanrequired

Whether the cards needed for this badge are non-marketable on Steam (cannot be bought/sold)

isSalebooleanrequired

lastCompletionstring<date-time> | nullrequired

namestringrequired

noListingbooleanrequired

Whether at least one card for this badge is not currently listed on the market

priceinteger<int32>requireddeprecated

scarcityinteger<int64>required

min 0

steamIdinteger<int32>required

min 0

trackedHoldersinteger<int64>required

min 0

playtimeV1AccountPlaytimeDataPoint[] | nullrequired

Show properties

Array of V1AccountPlaytimeDataPoint

appIdinteger<int32>required

The app id

min 0

imagestringrequired

The image of the app

namestringrequired

The name of the app

playtimeinteger<int32>required

The playtime of the app

min 0

scarcityV1AppBadge[] | nullrequired

Show properties

Array of V1AppBadge

accountInfoAccountBadgeInfo | null

Show properties

completionTimestring<date-time>required

The time the badge was completed

levelinteger<int32>required

The level of the badge

min 0

xpinteger<int32>required

The xp of the badge

min 0

appIdinteger<int32>required

min 0

appImagestringrequired

appNamestringrequired

badgeIdstringrequired

badgeImagestringrequired

baseLevelinteger<int32>required

The level this badge starts at

min 0

baseXpinteger<int32>required

The XP the badge gives per level

min 0

cardCountinteger<int32>required

Total trading cards Steam defines for this app (per side; foil and normal share the same count)

min 0

firstCompletionstring<date-time> | nullrequired

highestLevelinteger<int64>required

isEventbooleanrequired

isFoilbooleanrequired

isNmcbooleanrequired

Whether the cards needed for this badge are non-marketable on Steam (cannot be bought/sold)

isSalebooleanrequired

lastCompletionstring<date-time> | nullrequired

namestringrequired

noListingbooleanrequired

Whether at least one card for this badge is not currently listed on the market

priceinteger<int32>requireddeprecated

scarcityinteger<int64>required

min 0

steamIdinteger<int32>required

min 0

trackedHoldersinteger<int64>required

min 0

xpobjectrequired

400

Bad Request

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

401

Unauthorized

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

404

Not Found

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

422

Unprocessable Entity

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

500

Internal Server Error

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

Request body

Request

curl -X POST 'https://api.steamsets.com/v1/account.getDataPoints' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": {
    "accountId": 0,
    "steamId64": "stringstringstrin"
  },
  "vanity": {
    "type": "steam",
    "value": "string"
  }
}'

const response = await fetch("https://api.steamsets.com/v1/account.getDataPoints", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"id\": {\n    \"accountId\": 0,\n    \"steamId64\": \"stringstringstrin\"\n  },\n  \"vanity\": {\n    \"type\": \"steam\",\n    \"value\": \"string\"\n  }\n}"
});

import requests

response = requests.post(
    "https://api.steamsets.com/v1/account.getDataPoints",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"id\": {\n    \"accountId\": 0,\n    \"steamId64\": \"stringstringstrin\"\n  },\n  \"vanity\": {\n    \"type\": \"steam\",\n    \"value\": \"string\"\n  }\n}",
)

Response

{
  "mostXp": [
    {
      "accountInfo": {
        "completionTime": "2023-01-01T00:00:00Z",
        "level": 123456,
        "xp": 123456
      },
      "appId": 0,
      "appImage": "string",
      "appName": "string",
      "badgeId": "string",
      "badgeImage": "string",
      "baseLevel": 0,
      "baseXp": 0,
      "cardCount": 0,
      "firstCompletion": "2019-08-24T14:15:22Z",
      "highestLevel": 0,
      "isEvent": true,
      "isFoil": true,
      "isNmc": true,
      "isSale": true,
      "lastCompletion": "2019-08-24T14:15:22Z",
      "name": "string",
      "noListing": true,
      "price": 0,
      "scarcity": 0,
      "steamId": 0,
      "trackedHolders": 0
    }
  ],
  "playtime": [
    {
      "appId": 730,
      "image": "someHash.idk",
      "name": "CS2",
      "playtime": 15
    }
  ],
  "scarcity": [
    {
      "accountInfo": {
        "completionTime": "2023-01-01T00:00:00Z",
        "level": 123456,
        "xp": 123456
      },
      "appId": 0,
      "appImage": "string",
      "appName": "string",
      "badgeId": "string",
      "badgeImage": "string",
      "baseLevel": 0,
      "baseXp": 0,
      "cardCount": 0,
      "firstCompletion": "2019-08-24T14:15:22Z",
      "highestLevel": 0,
      "isEvent": true,
      "isFoil": true,
      "isNmc": true,
      "isSale": true,
      "lastCompletion": "2019-08-24T14:15:22Z",
      "name": "string",
      "noListing": true,
      "price": 0,
      "scarcity": 0,
      "steamId": 0,
      "trackedHolders": 0
    }
  ],
  "xp": {
    "property1": {
      "property1": 0,
      "property2": 0
    },
    "property2": {
      "property1": 0,
      "property2": 0
    }
  }
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}