---
title: "Facet the Steam games dataset"
method: GET
path: "/datasets/steam-games/facets"
tags: ["Datasets"]
---

# Facet the Steam games dataset

`GET /datasets/steam-games/facets`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/steam-games/facets`
- Auth: API key in header `x-api-key`

Returns terms aggregation counts for the Steam games dataset. Facet enum: `type`, `developer`, `publisher`, `genres`, `categories`, `tags`, `primary_tag`, `price_tier`, `review_tier`, `owners_bucket`, `release_year`, `run_id`, `is_free`, `coming_soon`, `platform_windows`, `platform_mac`, `platform_linux`. price_tier enum: `free`, `under5`, `5to15`, `15to30`, `30to60`, `over60`. review_tier enum: `overwhelmingly_positive`, `very_positive`, `positive`, `mostly_positive`, `mixed`, `mostly_negative`, `negative`, `very_negative`, `overwhelmingly_negative`, `insufficient`.

## Query parameters

- `facet` 'type' | 'developer' | 'publisher' | 'genres' | 'categories' | 'tags' | 'primary_tag' | 'price_tier' | 'review_tier' | 'owners_bucket' | 'release_year' | 'run_id' | 'is_free' | 'coming_soon' | 'platform_windows' | 'platform_mac' | 'platform_linux', required
- `q` string
- `type` string
- `developer` string
- `publisher` string
- `genre` string
- `category` string
- `tag` string
- `price_tier` 'free' | 'under5' | '5to15' | '15to30' | '30to60' | 'over60'
- `review_tier` 'overwhelmingly_positive' | 'very_positive' | 'positive' | 'mostly_positive' | 'mixed' | 'mostly_negative' | 'negative' | 'very_negative' | 'overwhelmingly_negative' | 'insufficient'
- `owners_bucket` string
- `run_id` string
- `is_free` boolean
- `windows` boolean
- `mac` boolean
- `linux` boolean
- `on_sale` boolean
- `min_price_cents` integer
- `max_price_cents` integer
- `min_owners` integer
- `min_positive` integer
- `min_total_reviews` integer
- `min_review_score` number
- `min_metacritic` integer
- `min_ccu` integer
- `min_release_year` integer
- `max_release_year` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsSteamGamesFacetResponseDoc
  - `code` integer
  - `data` DatasetsSteamFacetResponse
    - `dataset` string
    - `facet` string
    - `items` EsSteamGameDatasetFacetItem[]
      - `count` integer
      - `value` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[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)