---
title: "Top accounts by unique viewers in a window"
method: POST
path: "/v1/account.getTrending"
tags: ["account"]
---

# Top accounts by unique viewers in a window

`POST /v1/account.getTrending`

## Request body

- AccountGetTrendingRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `limit` integer — Max accounts returned. Default 100.
  - `window` '24h' | '7d' | '30d', required — Lookback window for trending compute. 24h is high-volatility (small samples); 7d is the default surface.

## Response `200`

OK

- AccountGetTrendingResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `accounts` TrendingAccount[], nullable, required
    - `account` LeaderboardAccount, nullable
      - `animatedAvatar` string, required — The animated avatar of the account
      - `apps` integer, required — The number of apps the account has
      - `avatar` string, required — The avatar hash of the account
      - `avatarFrame` string, required — The avatar frame of the account
      - `awardsGiven` integer, required — The number of awards the account has
      - `awardsReceived` integer, required — The number of awards the account has
      - `background` string, required — The background of the account
      - `badges` integer, required — The number of badges the account has
      - `bans` integer, required — The number of bans
      - `city` LeaderboardCity, nullable
        - `name` string, required — The name of the city
      - `country` LeaderboardCountry, nullable
        - `code` string — The code of the country
        - `name` string, required — The name of the country
      - `createdAt` string, date-time, required — The time the account was created
      - `donated` integer, required — The total of donations the account has
      - `economyBan` string, required — The economy ban of the account
      - `foilBadges` integer, required — The number of foil badges the account has
      - `friends` integer, required — The number of friends the account has
      - `gameBans` integer, required — The number of game bans
      - `level` integer, required — The level of the account
      - `miniBackground` string, required — The mini background of the account
      - `name` string, required — The name of the account
      - `nameEffect` 'none' | 'rainbow' | 'glitch' | 'shadow' | 'neon' | 'retro' | 'stamped' | 'shatter' | 'typewriter' | 'vaporwave' | 'sunken', required — Donator name effect, none when unset or the account no longer holds an entitling role
      - `normalBadges` integer, required — The number of normal badges the account has
      - `playtime` integer, required — The playtime of the account
      - `pointsGiven` integer, required — The number of points the account has
      - `pointsReceived` integer, required — The number of points the account has
      - `privacy` 'public' | 'private' | 'friends_only', required — The privacy of the account
      - `region` LeaderboardRegion, nullable
        - `name` string, required — The name of the region
      - `roles` Role[], nullable, required — The roles of the account
        - `extras` object, nullable, required — Extra data associated with the role
        - `rating` integer, required — The higher the more presedence it has
        - `role` 'user' | 'donator' | 'staff' | 'developer' | 'partner' | 'owner' | 'amethyst' | 'amber' | 'emerald' | 'sapphire' | 'ruby' | 'diamond' | 'contributor' | 'early_supporter' | 'beta' | 'translator' | 'top_100' | 'badge_scout' | 'nitro_booster' | 'astral' | 'nebula', required
      - `state` LeaderboardState, nullable
        - `name` string, required — The name of the state
      - `steamId` string, required — The steam id
      - `steamSetsScore` integer, required — The steam sets score
      - `steamSetsVanity` string, required — The vanity of the account
      - `steamVanity` string, required — The vanity of the account
      - `themeColor` string, nullable, required — Donator profile theme color as #RRGGBB (no alpha), null when unset or the account no longer holds an entitling role
      - `vacBans` integer, required — The number of vac bans
      - `xp` integer, required — The number of xp the account has
    - `accountId` integer, required
    - `totalViews` integer, required — Total profile loads in the window
    - `uniqueViews` integer, required — Distinct viewers in the window

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/steamsets/apis/steamsets-api.md) · [All operations](https://skmtc.net/steamsets/apis/steamsets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/steamsets/steamsets-api/versions/2e8ba266b27f/schema)