---
seo:
  description: SteamSets API reference.
sidebar:
  label: Overview
title: SteamSets API
---
Version 1.0.0

Base URL: `https://api.steamsets.com`

## Accounts

Steam profiles, badge collections, friends, and owned apps.

- [`POST /v1/account.compareBadges`](/reference/accounts/compare-badges) — Compare badge collections between accounts.
- [`POST /v1/account.findFriendPath`](/reference/accounts/account-find-friend-path) — Find up to N shortest friend paths between two accounts.
- [`POST /v1/account.getBadgeHeatmap`](/reference/accounts/account-get-badge-heatmap) — Get monthly badge crafting counts for an account.
- [`POST /v1/account.getBadgeStats`](/reference/accounts/account-get-badge-stats) — Get account badge statistics.
- [`POST /v1/account.getDataPoints`](/reference/accounts/account-get-data-points) — Get account data points for charts.
- [`POST /v1/account.getInfo`](/reference/accounts/account-get-info) — Get account profile information.
- [`POST /v1/account.getTrending`](/reference/accounts/account-get-trending) — Top accounts by unique viewers in a window.
- [`POST /v1/account.getViewStats`](/reference/accounts/get-view-stats) — Get profile view counts (24h/7d/30d × unique/total) for an account.
- [`POST /v1/account.listApps`](/reference/accounts/account-list-apps) — List account owned apps.
- [`POST /v1/account.listBadges`](/reference/accounts/account-list-badges) — List account badges.
- [`POST /v1/account.listCraftedLevels`](/reference/accounts/account-list-crafted-levels) — List crafted badge levels.
- [`POST /v1/account.listFriends`](/reference/accounts/account-list-friends) — List account friends.
- [`POST /v1/account.listInventorySets`](/reference/accounts/account-list-inventory-sets) — List inventory sets.
- [`POST /v1/account.listLeaderboardHistory`](/reference/accounts/account-list-leaderboard-history) — Get leaderboard history.
- [`POST /v1/account.listOwnedBadges`](/reference/accounts/account-list-owned-badges) — List owned badges.
- [`POST /v1/account.listOwnedGroups`](/reference/accounts/account-list-owned-groups) — List groups owned by account.
- [`POST /v1/account.queueUpdate`](/reference/accounts/account-queue-update) — Queue account update.
- [`POST /v1/account.refreshInventory`](/reference/accounts/account-refresh-inventory) — Refresh inventory.
- [`POST /v1/account.refreshSession`](/reference/accounts/account-refresh-session) — Refresh session token.
- [`GET /v1/account.subscribe`](/reference/accounts/account-subscribe) — Server-sent-events stream of per-account updates (queue status, view ticks, update progress).
- [`POST /v1/account.updateProgress`](/reference/accounts/account-update-progress) — Get the live progress of an account's most recent update.

## Badges

Steam badges, their tags, and the accounts that crafted them.

- [`POST /v1/badge.getTags`](/reference/badges/badge-get-tags) — Get a badge's tags for editing.
- [`POST /v1/badge.listCrafters`](/reference/badges/badge-list-crafters) — List accounts that own a badge (earliest completion first). Donator perk — page size scales with Patreon tier.
- [`POST /v1/badge.listTags`](/reference/badges/badge-list-tags) — List badge tags.
- [`GET /v1/badge.pricing.subscribe`](/reference/badges/badge-pricing-subscribe) — Server-sent-events stream of badge pricing ticks. Forwards every tick — filter client-side.
- [`POST /v1/badge.setTags`](/reference/badges/badge-set-tags) — Replace a badge's tags.

## Apps

Steam apps (games), their badges, and the accounts that own them.

- [`POST /v1/app.listBadges`](/reference/apps/app-list-badges) — List app badges.
- [`POST /v1/app.listOwners`](/reference/apps/app-list-owners) — List accounts that own an app (highest playtime first). Donator perk — page size scales with Patreon tier.

## Items

Owners of trading cards and booster packs.

- [`POST /v1/item.findOwners`](/reference/items/item-find-owners) — Find owners of one or more trading cards or booster packs. Friend paths from the requester are included for logged-in callers.

## Leaderboards

Account and group rankings, and how they change over time.

- [`POST /v1/leaderboard.getAccountLeaderboard`](/reference/leaderboards/leaderboard-get-account-leaderboard) — Get account leaderboard.
- [`POST /v1/leaderboard.getBucketLeaders`](/reference/leaderboards/leaderboard-get-bucket-leaders) — Get the top account in each value bucket.
- [`POST /v1/leaderboard.getChanges`](/reference/leaderboards/get-changes) — Top movers in a windowed delta on a leaderboard.
- [`POST /v1/leaderboard.getGroupLeaderboard`](/reference/leaderboards/leaderboard-get-group-leaderboard) — Get group leaderboard.
- [`POST /v1/leaderboard.getLowestRanks`](/reference/leaderboards/leaderboard-get-lowest-ranks) — Get lowest ranked accounts.
- [`POST /v1/leaderboard.listBadges`](/reference/leaderboards/leaderboard-list-badges) — List leaderboard badges.
- [`POST /v1/leaderboard.previewAccountRank`](/reference/leaderboards/leaderboard-preview-account-rank) — Preview account rank.

## Activity

The activity feed of one account or of all of SteamSets.

- [`POST /v1/activity.listAccountFeed`](/reference/activity/list-account-feed) — List the activity feed for a single account (profile timeline).
- [`POST /v1/activity.listGlobalFeed`](/reference/activity/list-global-feed) — List the global activity feed.
- [`GET /v1/activity.streamGlobalFeed`](/reference/activity/stream-global-feed) — Live server-sent-events stream of the global activity feed.

## Stats

Platform statistics, as a snapshot or as a live stream.

- [`POST /v1/stats.getStats`](/reference/stats/stats-get-stats) — Get platform statistics.
- [`GET /v1/stats.subscribe`](/reference/stats/stats-subscribe) — Server-sent-events stream of platform stats. Emits a snapshot, then deltas as the queues commit them.

## Search

What people search for on SteamSets.

- [`POST /v1/search.getTrending`](/reference/search/search-get-trending) — Top search queries in a window, by unique searcher count.

## Site

Site-wide broadcasts as a live stream.

- [`GET /v1/site.subscribe`](/reference/site/site-subscribe) — Server-sent-events stream of site-wide broadcasts (maintenance, announcements, etc).

## Donations

Progress toward the monthly donation goal.

- [`POST /v1/donate.getGoal`](/reference/donations/donate-get-goal) — Get this month's donation goal progress.
