Deals List
Get current deals. Follows the same rules as deals list displayed on the website, which means that you will not get one game more than once in the list.
For each game, the best price is displayed, ignoring stores that currently don't have game on sale, even if they currently have a better price. If you want to included non-sale prices, use nondeals parameter.
You can define parameters either in a query part of a URL, or you can sent them in a request body. Since the specification for GET requests with body is unclear, we also provide more standard POST endpoint as a fallback.
You can authorize with either api key, or OAuth. If you use OAuth, the user data filters will work, e.g. in Waitlist filter.
Request
- Base URL: https://api.isthereanydeal.com
- URL: https://api.isthereanydeal.com/deals/v2
- Auth: one of:
- API key in query parameter key
- API key in header ITAD-API-Key
- OAuth 2 (authorization code, authorization URL https://isthereanydeal.com/oauth/authorize/, token URL https://isthereanydeal.com/oauth/token/, scopes: wait_read, coll_read)
Query parameters
Two letter country code (ISO 3166-1 alpha-2)
Deals list offset
How many deals to return
Sorting values, same as in deals list on the website
Load non-sale prices
Load deals for mature prices
List of shop IDs separated by comma
There are two ways how you can supply filters.
- A base64 encoded lz compressed filter json - this is what ITAD uses, you can copy and paste filters from the URL
- Filter JSON (see request body for specification). Examples are omitting URL encoding for clarity, but make sure to URL encode these.
Request body
Response
Deals list
Changes
No recorded changes to this operation across all 1 revision of this API.