Datasets

Facet the Steam games dataset

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.

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

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

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

qstring

Full-text query over name, developer and publisher, max 256 characters

typestring

Exact storefront type filter, max 128 characters

developerstring

Exact developer filter, max 128 characters

publisherstring

Exact publisher filter, max 128 characters

genrestring

Exact genre filter, max 128 characters

categorystring

Exact store category filter, max 128 characters

tagstring

Exact community-tag filter (e.g. Roguelike, Cozy), max 128 characters

price_tier'free' | 'under5' | '5to15' | '15to30' | '30to60' | 'over60'

Price-tier enum: free, under5, 5to15, 15to30, 30to60, over60

review_tier'overwhelmingly_positive' | 'very_positive' | 'positive' | 'mostly_positive' | 'mixed' | 'mostly_negative' | 'negative' | 'very_negative' | 'overwhelmingly_negative' | 'insufficient'

Review-tier enum: overwhelmingly_positive, very_positive, positive, mostly_positive, mixed, mostly_negative, negative, very_negative, overwhelmingly_negative, insufficient

owners_bucketstring

Exact SteamSpy owners-range bucket filter, max 128 characters

run_idstring

Exact crawl run-id filter, max 128 characters

is_freeboolean

Filter by free-to-play flag

windowsboolean

Filter by Windows support

macboolean

Filter by macOS support

linuxboolean

Filter by Linux support

on_saleboolean

Filter by titles currently discounted (discount_pct > 0)

min_price_centsinteger

Minimum current price in cents

max_price_centsinteger

Maximum current price in cents

min_ownersinteger

Minimum estimated owners (SteamSpy owners midpoint)

min_positiveinteger

Minimum positive review count

min_total_reviewsinteger

Minimum total review count

min_review_scorenumber

Minimum positive-review ratio, 0 through 1

min_metacriticinteger

Minimum Metacritic score, 0 through 100

min_ccuinteger

Minimum peak concurrent users yesterday

min_release_yearinteger

Minimum release year

max_release_yearinteger

Maximum release year

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.