Docs menu

Datasets API endpoint

Search the steam-charts dataset API

Searches daily snapshots of Steam's player-count and sales charts, stored in a search index (one document per chart × country × snapshot × rank) so history accumulates. Charts: `most_played` (weekly peak concurrent), `concurrent` (live concurrent players), `top_sellers` (weekly sales; country-specific). With no `date` the latest snapshot is returned (today's chart); pair `app_id` with `sort=date_desc` for an app's rank/players over time. Country is `global` for the player-count charts or an ISO code (e.g. `us`) for `top_sellers`. Sort enum: `rank`, `rank_desc`, `date_desc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

GETapiKey1 credit/record returned · minimum 2Datasetsdatasets.steamChartsSearchResponseDoc/datasets/steam-charts/search

Endpoint facts

Method: GET
API path: /datasets/steam-charts/search
Auth: apiKey
Credits: 1 credit/record returned · minimum 2
Charged on: Successful 2xx responses only
Platform: Datasets
Execution: Stored dataset records. No live scraping, browser session or proxy routing.
Response schema: #/definitions/datasets.steamChartsSearchResponseDoc

Stored structured dataset search API Try Search the steam-charts dataset API in Playground Datasets API documentation

How this endpoint behaves

Searches daily snapshots of Steam's player-count and sales charts, stored in a search index. One document per chart × country × snapshot × rank, so re-crawls accumulate a time series: today's chart, an app's rank and player count over time, and day-over-day movers. Returns structured ranking records without triggering live scraping (for the live charts use /steam/charts/* and /steam/top-sellers).

Dataset id enum:

steam-charts

Query parameters:

q: optional full-text query over the game name, max 256 characters.
chart: optional chart enum: most_played, concurrent, top_sellers.
country: optional market filter — global for the player-count charts, or an ISO country code (e.g. us) for top_sellers, max 128 characters.
app_id: optional exact Steam app id filter. Pair with sort=date_desc for an app's rank and player count over time.
date: optional snapshot date filter, yyyy-MM-dd. Defaults to the latest available snapshot (today's chart).
sort: optional sort enum: rank (chart order), rank_desc, date_desc (rank over time). Defaults to rank.
page: optional page number, defaults to 1.
page_size: optional page size, defaults to 20 and maxes at 100.

Each record carries chart, country, snapshot_date, rank, app_id, name, and the chart's metric: peak_in_game and last_week_rank for most_played, concurrent_in_game (plus peak_in_game) for concurrent, and final_price_cents + review_summary for top_sellers.

Response behavior:

With no date (and no single-app history request) the latest snapshot is resolved automatically, so the default response is today's chart in rank order.
The response echoes the resolved snapshot_date so callers know which day was returned.
The maximum result window is 10000; page * page_size must not exceed 10000.
Invalid enum values return the standard invalid params envelope.
A not-yet-populated index returns an empty items list rather than an error.
Does not trigger live scraping.

Billing

1 credit per record returned, minimum 2. A search that returns 20 records costs 20 credits, a full page of 100 costs 100, and an empty or one-record result costs 2. You are charged for what comes back, not for the page_size you ask for, but your balance must cover the requested page_size for the call to be accepted. The response header x-credit-cost shows what a call was charged.

Live monitoring

Monitored request: GET /datasets/steam-charts/search?page_size=2
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.60 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /datasets/steam-charts/search?page_size=20
Items in items: 20
Fields filled in every checked item: 9
Fields empty in some or all items: 3

Field	Filled in, of 20 checked	Values in the sample
chart_uid	20
chart	20
country	20
snapshot_date	20	2026-10-13
rank	20	1 to 4, median 2
app_id	20
name	20
peak_in_game	4	367,485 to 1,248,671, median 679,146
concurrent_in_game	4	186,038 to 471,563, median 236,487
review_summary	20
crawled_at	20	2026-10-13
final_price_cents	8	3,999 to 979,000, median 5,999

Request parameters

Parameter	Type	Required	Default	Description
q	string	No		Full-text query over the game name, max 256 characters
chart	string	No		Chart enum: most_played, concurrent, top_sellers Allowed values: most_played, concurrent, top_sellers.
country	string	No		Market filter: global (player-count charts) or an ISO country code (top_sellers), max 128 characters
app_id	string	No		Exact Steam app id filter; pair with sort=date_desc for rank/players history
date	string	No	the latest snapshot	Snapshot date filter yyyy-MM-dd; defaults to the latest snapshot
sort	string	No		Sort enum: rank, rank_desc, date_desc Allowed values: rank, rank_desc, date_desc.
page	integer	No	1	Page number, defaults to 1
page_size	integer	No	20 and maxes at 100	Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/datasets/steam-charts/search?q=coffee&chart=most_played&country=us&sort=rank&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "steam-charts",
    "items": [
      {
        "chart_uid": "concurrent:global:2026-07-11:1",
        "chart": "concurrent",
        "country": "global",
        "snapshot_date": "2026-07-11",
        "rank": 1,
        "app_id": "730",
        "name": "Counter-Strike 2",
        "concurrent_in_game": 899091,
        "peak_in_game": 1308574
      }
    ],
    "snapshot_date": "2026-07-11",
    "page": 1,
    "page_size": 20,
    "total": 100,
    "sort": "rank"
  }
}

Request schema

No body schema

Response schema

#/definitions/datasets.steamChartsSearchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	datasets.SteamChartsSearchResponse	No
data.dataset	string	No
data.items	array	No
data.items[].app_id	string	No
data.items[].chart	string	No
data.items[].chart_uid	string	No
data.items[].concurrent_in_game	integer	No
data.items[].country	string	No
data.items[].crawled_at	string	No
data.items[].final_price_cents	integer	No
data.items[].last_week_rank	integer	No
data.items[].name	string	No
data.items[].peak_in_game	integer	No
data.items[].rank	integer	No
data.items[].review_summary	string	No
data.items[].snapshot_date	string	No
data.page	integer	No
data.page_size	integer	No
data.snapshot_date	string	No
data.sort	string	No
data.total	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/datasets/steam-charts/search?q=coffee&chart=most_played&country=us&sort=rank&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Datasets endpoint docs Stored structured dataset search API Stored Datasets List API documentation Airbnb Markets Dataset Facets API documentation Airbnb Markets Dataset Country API documentation Nearby Airbnb Markets Dataset API documentation Airbnb Markets Dataset Search API documentation Facet Apple Podcasts shows dataset API documentation

Open in Playground Back to group

Docs menu

Datasets API endpoint

Search the steam-charts dataset API

GETapiKey1 credit/record returned · minimum 2Datasetsdatasets.steamChartsSearchResponseDoc/datasets/steam-charts/search

Endpoint facts

Method: GET
API path: /datasets/steam-charts/search
Auth: apiKey
Credits: 1 credit/record returned · minimum 2
Charged on: Successful 2xx responses only
Platform: Datasets
Execution: Stored dataset records. No live scraping, browser session or proxy routing.
Response schema: #/definitions/datasets.steamChartsSearchResponseDoc

Stored structured dataset search API Try Search the steam-charts dataset API in Playground Datasets API documentation

How this endpoint behaves

Dataset id enum:

steam-charts

Query parameters:

q: optional full-text query over the game name, max 256 characters.
chart: optional chart enum: most_played, concurrent, top_sellers.
country: optional market filter — global for the player-count charts, or an ISO country code (e.g. us) for top_sellers, max 128 characters.
app_id: optional exact Steam app id filter. Pair with sort=date_desc for an app's rank and player count over time.
date: optional snapshot date filter, yyyy-MM-dd. Defaults to the latest available snapshot (today's chart).
sort: optional sort enum: rank (chart order), rank_desc, date_desc (rank over time). Defaults to rank.
page: optional page number, defaults to 1.
page_size: optional page size, defaults to 20 and maxes at 100.

Response behavior:

With no date (and no single-app history request) the latest snapshot is resolved automatically, so the default response is today's chart in rank order.
The response echoes the resolved snapshot_date so callers know which day was returned.
The maximum result window is 10000; page * page_size must not exceed 10000.
Invalid enum values return the standard invalid params envelope.
A not-yet-populated index returns an empty items list rather than an error.
Does not trigger live scraping.

Billing

Live monitoring

Monitored request: GET /datasets/steam-charts/search?page_size=2
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.60 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /datasets/steam-charts/search?page_size=20
Items in items: 20
Fields filled in every checked item: 9
Fields empty in some or all items: 3

Field	Filled in, of 20 checked	Values in the sample
chart_uid	20
chart	20
country	20
snapshot_date	20	2026-10-13
rank	20	1 to 4, median 2
app_id	20
name	20
peak_in_game	4	367,485 to 1,248,671, median 679,146
concurrent_in_game	4	186,038 to 471,563, median 236,487
review_summary	20
crawled_at	20	2026-10-13
final_price_cents	8	3,999 to 979,000, median 5,999

Request parameters

Parameter	Type	Required	Default	Description
q	string	No		Full-text query over the game name, max 256 characters
chart	string	No		Chart enum: most_played, concurrent, top_sellers Allowed values: most_played, concurrent, top_sellers.
country	string	No		Market filter: global (player-count charts) or an ISO country code (top_sellers), max 128 characters
app_id	string	No		Exact Steam app id filter; pair with sort=date_desc for rank/players history
date	string	No	the latest snapshot	Snapshot date filter yyyy-MM-dd; defaults to the latest snapshot
sort	string	No		Sort enum: rank, rank_desc, date_desc Allowed values: rank, rank_desc, date_desc.
page	integer	No	1	Page number, defaults to 1
page_size	integer	No	20 and maxes at 100	Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/datasets/steam-charts/search?q=coffee&chart=most_played&country=us&sort=rank&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "steam-charts",
    "items": [
      {
        "chart_uid": "concurrent:global:2026-07-11:1",
        "chart": "concurrent",
        "country": "global",
        "snapshot_date": "2026-07-11",
        "rank": 1,
        "app_id": "730",
        "name": "Counter-Strike 2",
        "concurrent_in_game": 899091,
        "peak_in_game": 1308574
      }
    ],
    "snapshot_date": "2026-07-11",
    "page": 1,
    "page_size": 20,
    "total": 100,
    "sort": "rank"
  }
}

Request schema

No body schema

Response schema

#/definitions/datasets.steamChartsSearchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	datasets.SteamChartsSearchResponse	No
data.dataset	string	No
data.items	array	No
data.items[].app_id	string	No
data.items[].chart	string	No
data.items[].chart_uid	string	No
data.items[].concurrent_in_game	integer	No
data.items[].country	string	No
data.items[].crawled_at	string	No
data.items[].final_price_cents	integer	No
data.items[].last_week_rank	integer	No
data.items[].name	string	No
data.items[].peak_in_game	integer	No
data.items[].rank	integer	No
data.items[].review_summary	string	No
data.items[].snapshot_date	string	No
data.page	integer	No
data.page_size	integer	No
data.snapshot_date	string	No
data.sort	string	No
data.total	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/datasets/steam-charts/search?q=coffee&chart=most_played&country=us&sort=rank&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Search the steam-charts dataset API

Endpoint facts

How this endpoint behaves

Billing

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Search the steam-charts dataset API

Endpoint facts

How this endpoint behaves

Billing

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related