---
title: "Get Steam's weekly top-sellers chart for a country"
method: GET
path: "/steam/top-sellers"
tags: ["Steam"]
---

# Get Steam's weekly top-sellers chart for a country

`GET /steam/top-sellers`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/steam/top-sellers`
- Auth: API key in header `x-api-key`

Returns the store's weekly top-sellers chart for a country, each rank carrying the full store item (name, price, weighted community tags, review summary, platforms). cc selects the country whose sales ranking and currency are returned.

## Query parameters

- `cc` string
- `l` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SteamTopSellersResponseDoc
  - `code` integer
  - `data` SteamTopSellersResponse
    - `count` integer
    - `country_code` string
    - `ranks` SteamTopSellerRank[]
      - `appid` integer
      - `item` SteamCategoryItem
        - `appid` integer
        - `developers` string[]
        - `name` string
        - `platforms` SteamPlatforms
          - `linux` boolean: Whether the title supports Linux.
          - `mac` boolean: Whether the title supports macOS.
          - `windows` boolean: Whether the title supports Windows.
        - `price_overview` SteamPrice
          - `currency` string: Currency code of the prices, such as `USD`.
          - `discount_percent` integer: Discount currently applied, as a percentage.
          - `final` integer: Price after any discount, in minor currency units such as cents.
          - `final_formatted` string: Price after any discount, formatted for display as Steam shows it.
          - `initial` integer: Price before any discount, in minor currency units such as cents.
          - `initial_formatted` string: Price before any discount, formatted for display as Steam shows it.
        - `publishers` string[]
        - `release_date_unix` integer
        - `review_count` integer
        - `review_percent_positive` integer
        - `review_summary` string
        - `short_description` string
        - `tags` SteamWeightedTag[]
          - `tagid` integer
          - `weight` integer
        - `type` integer
        - `url` string
      - `rank` integer
    - `source_url` string
    - `start_date_unix` integer
  - `msg` string

## Other responses

- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)