---
title: "Top search queries in a window, by unique searcher count"
method: POST
path: "/v1/search.getTrending"
tags: ["search"]
---

# Top search queries in a window, by unique searcher count

`POST /v1/search.getTrending`

## Request body

- SearchGetTrendingRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `limit` integer — Max queries returned. Default 100.
  - `source` 'badge' | 'app' | 'account', required — Which search surface to query.
  - `window` '24h' | '7d' | '30d', required — Lookback window for trending compute.

## Response `200`

OK

- SearchGetTrendingResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `searches` TrendingSearch[], nullable, required
    - `query` string, required — The search query as first typed
    - `totalSearches` integer, required — Total times this query was searched
    - `uniqueSearchers` integer, required — Distinct searchers 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)