GET /deals
Summary: List game deals
Operation ID: getDeals
Auth: unknown
Operation ID: getDeals
Auth: unknown
Description
Returns a list of game deals with optional filtering by store, price range, metacritic score, Steam rating, and more.
Parameters (16)
AAA
(integer, query, optional)
Filter for AAA titles only (0 = no, 1 = yes)
Constraints: {'enum': [0, 1]}
desc
(integer, query, optional, default: 0)
Sort order (0 = ascending, 1 = descending)
Constraints: {'enum': [0, 1]}
exact
(integer, query, optional)
Exact title match (0 = no, 1 = yes)
Constraints: {'enum': [0, 1]}
lowerPrice
(number, query, optional)
Minimum price filter
Constraints: {'minimum': 0}
metacritic
(integer, query, optional)
Minimum Metacritic score (0-100)
Constraints: {'minimum': 0, 'maximum': 100}
onSale
(integer, query, optional)
Filter for games currently on sale (0 = no, 1 = yes)
Constraints: {'enum': [0, 1]}
output
(string, query, optional)
Response format (only 'json' is supported)
Constraints: {'enum': ['json']}
pageNumber
(integer, query, optional, default: 0)
Page number for pagination (0-indexed)
Constraints: {'minimum': 0}
pageSize
(integer, query, optional, default: 60)
Number of results per page
Constraints: {'minimum': 1, 'maximum': 60}
sortBy
(string, query, optional, default: DealRating)
Sort results by field
Constraints: {'enum': ['DealRating', 'Title', 'Savings', 'Price', 'Metacritic', 'Reviews', 'Release', 'Store', 'recent']}
steamAppID
(string, query, optional)
Filter by Steam App ID
steamRating
(integer, query, optional)
Minimum Steam review percentage (0-100)
Constraints: {'minimum': 0, 'maximum': 100}
steamworks
(integer, query, optional)
Filter for games that activate on Steam (0 = no, 1 = yes)
Constraints: {'enum': [0, 1]}
storeID
(string, query, optional)
Filter by store ID (comma-separated for multiple stores)
title
(string, query, optional)
Search by game title (exact match)
upperPrice
(number, query, optional)
Maximum price filter
Constraints: {'minimum': 0}
Examples (2)
| Title | Type | URL | Action |
|---|---|---|---|
| List game deals | openapi-spec |
https://www.cheapshark.com/api/1.0/deals?storeID=1,2,3 |
|
| List game deals | probe-gate |
https://www.cheapshark.com/api/1.0/deals?storeID=1%2C2%2C3&pageNumber=0&pageSize=60&sortBy=DealRating&desc=0 |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 09:43:45.083921 | 200 | 4331ms | |
| 2026-03-22T13:32:00.596637 | 200 | 1164ms |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 09:43:45.083921 | 05e73b2afb70 |
84a816a9a9ca |