IsThereAnyDeal API (2.0.0)

Download OpenAPI specification:Download

IsThereAnyDeal API provides programmatic access to features found at IsThereAnyDeal.

Terms of Service

API is provided in good faith. We trust you won't misuse the API to damage IsThereAnyDeal, its users or its reputation.

You MAY use this API for commercial purposes IF the resulting app is available to public. If you want to use this API privately contact us.
You SHOULD provide a link to IsThereAnyDeal.com or mention IsThereAnyDeal API.
You MUST NOT make an impression that you are affiliated with IsThereAnyDeal, unless agreed otherwise. If you are interested in making an official app, please contact us.
You MUST NOT change provided data in any way. This means that you can't remove affiliate tags from the URLs, change prices and so on. You MAY use only part of data provided and enrich them from your own sources.
You MUST NOT make an app that could be considered a competition to IsThereAnyDeal or IsThereAnyDeal projects.
You MUST NOT use this API to directly or indirectly help the competition of IsThereAnyDeal.

All data are provided as-is. We reserve the right to deny you access to the API at any point without notice. If you are not sure about any of the points, please contact us.

Access

Most of the endpoints will be restricted by either API key or OAuth. In order to get neccessary keys, you have to register your app. Upon registration, api keys and OAuth credentials will be generated for you.

For some endpoints you might need explicit approval for use. In such cases, contact us.

OAuth

We support authorization code flow with PKCE extension.

You can find PKCE step-through tutorial at OAuth 2.0 PKCE Flow

Do not set hard limits for token lengths. Server will return access token as JWT of variable length. To authorize your endpoint access use Authorization header.

At the moment implicit flow is also enabled, but its usage is discouraged and support may be removed in the future

Rate Limiting

Access to API is rate limited and subject to change. You should get rate-limit info in appropriate headers. Further limits and restrictions may be added if we detect misuse.

If you have questions about limits, contact us.

Unstable and Internal Endpoints

Some endpoints are marked as unstable or internal. Unstable endpoints are publicly available, but the API may not be completely finalized yet - either the way the endpoint is called or the response may change at any time.

Internal APIs are available only for our own services. They are documented here for completeness.

Source

You can find source files for this documentation over at GitHub. Feel free to help us improve it.

service

Shops

Return information about shops

query Parameters

country

string = 2 characters

Default: "US"

Two letter country code (ISO 3166-1 alpha-2)

Responses

Response samples

200
400
default

Content type

application/json

[{"id": 19,
"title": "2game",
"deals": 3170,
"games": 3785,
"update": "2023-06-06T21:51:13+02:00"
},
{"id": 2,
"title": "AllYouPlay",
"deals": 435,
"games": 4926,
"update": "2023-06-06T22:10:25+02:00"
},
{"id": 3,
"title": "Amazon",
"deals": 0,
"games": 0,
"update": null
}
]

deals

Deals List

Get current deals. Follows 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.

Authorizations:

keySecurity

query Parameters

country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
offset	integer >= 0 Default: 0 Deals list offset
limit	integer [ 1 .. 200 ] Default: 20 How many deals to return
sort	string Examples: sort=-cut - Highest cut sort=price - Lowest price Sorting values, same as in deals list on the website
nondeals	boolean Default: false Load non-sale prices
mature	boolean Default: false Load deals for mature prices
shops	Array of numbers Examples: shops=61,35 - Only Steam (61) and GOG (35) List of shop IDs separated by comma
filter	string Filter string

Responses

Response samples

200
400
default

Content type

application/json

{"nextOffset": 3,
"hasMore": true,
"list": [{"id": "01846e7e-7e96-71fb-bf16-6979fa211638",
"slug": "ghost-master",
"title": "Ghost Master®",
"type": "game",
"deal": {"shop": {"id": 6,
"name": "Fanatical"
},
"price": {"amount": 3.89,
"amountInt": 389,
"currency": "USD"
},
"regular": {"amount": 4.99,
"amountInt": 499,
"currency": "USD"
},
"cut": 22,
"voucher": null,
"storeLow": {"amount": 3.66,
"amountInt": 366,
"currency": "USD"
},
"historyLow": {"amount": 0.55,
"amountInt": 55,
"currency": "USD"
},
"flag": null,
"drm": [{"id": 61,
"name": "Steam"
}
],
"platforms": [{"id": 1,
"name": "Windows"
}
],
"timestamp": "2023-06-06T21:47:39+02:00",
"expiry": "2023-06-10T18:00:00+02:00",
"url": "https://isthereanydeal.com/link/0184bc2c-4d32-713b-92eb-a0bc051212c7/"
}
},
{"id": "01846e7e-86b7-70b0-94f2-902edb836ef1",
"slug": "luxor-3",
"title": "Luxor 3",
"type": "game",
"deal": {"shop": {"id": 6,
"name": "Fanatical"
},
"price": {"amount": 7.89,
"amountInt": 789,
"currency": "USD"
},
"regular": {"amount": 9.99,
"amountInt": 999,
"currency": "USD"
},
"cut": 21,
"voucher": null,
"storeLow": {"amount": 7.89,
"amountInt": 789,
"currency": "USD"
},
"historyLow": {"amount": 7.89,
"amountInt": 789,
"currency": "USD"
},
"flag": "H",
"drm": [{"id": 61,
"name": "Steam"
}
],
"platforms": [{"id": 1,
"name": "Windows"
}
],
"timestamp": "2023-06-06T21:47:38+02:00",
"expiry": "2023-06-09T18:00:00+02:00",
"url": "https://isthereanydeal.com/link/0184bc2c-5135-71d9-813e-b7e84af11eb3/"
}
},
{"id": "01846e7e-87f3-70af-b4f1-b7524f49dab4",
"slug": "prince-of-persia-the-two-thrones",
"title": "Prince of Persia: The Two Thrones™",
"type": "game",
"deal": {"shop": {"id": 20,
"name": "GameBillet"
},
"price": {"amount": 1.75,
"amountInt": 175,
"currency": "USD"
},
"regular": {"amount": 9.99,
"amountInt": 999,
"currency": "USD"
},
"cut": 82,
"voucher": null,
"storeLow": {"amount": 1.66,
"amountInt": 166,
"currency": "USD"
},
"historyLow": {"amount": 1.66,
"amountInt": 166,
"currency": "USD"
},
"flag": null,
"drm": [ ],
"platforms": [ ],
"timestamp": "2023-06-06T21:59:42+02:00",
"expiry": null,
"url": "https://isthereanydeal.com/link/0184c0c4-f805-71ee-9394-3a5dd0cf0012/"
}
}
]
}

Prices

Get games' prices

Authorizations:

keySecurity

query Parameters

country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
nondeals	boolean Load non-sale prices
vouchers	boolean Allow vouchers in prices
capacity	integer >= 0 How many prices to load per each game, 0 or omit for no limit
shops	Array of integers Example: shops=65,35 List of shop IDs for which you want to load prices

Request Body schema: application/json

List of Game IDs for which to load prices

Array ([ 1 .. 200 ] items)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": "01849782-1017-7389-8de4-c97c587fd7e3",
"deals": [{"shop": {"id": 24,
"name": "GamersGate"
},
"price": {"amount": 5.93,
"amountInt": 593,
"currency": "USD"
},
"regular": {"amount": 21.99,
"amountInt": 2199,
"currency": "USD"
},
"cut": 73,
"voucher": null,
"storeLow": {"amount": 5.93,
"amountInt": 593,
"currency": "USD"
},
"historyLow": {"amount": 3.99,
"amountInt": 399,
"currency": "USD"
},
"flag": "S",
"drm": [{"id": 61,
"name": "Steam"
}
],
"platforms": [{"id": 1,
"name": "Windows"
},
{"id": 2,
"name": "Mac"
}
],
"timestamp": "2023-06-06T21:54:09+02:00",
"expiry": "2023-06-07T23:59:59+02:00",
"url": "https://isthereanydeal.com/link/0184d081-61ab-7036-994c-6e17f1348fe7/"
},
{"shop": {"id": 61,
"name": "Steam"
},
"price": {"amount": 6.59,
"amountInt": 659,
"currency": "USD"
},
"regular": {"amount": 21.99,
"amountInt": 2199,
"currency": "USD"
},
"cut": 70,
"voucher": null,
"storeLow": {"amount": 6.59,
"amountInt": 659,
"currency": "USD"
},
"historyLow": {"amount": 3.99,
"amountInt": 399,
"currency": "USD"
},
"flag": "S",
"drm": [ ],
"platforms": [{"id": 1,
"name": "Windows"
},
{"id": 2,
"name": "Mac"
},
{"id": 3,
"name": "Linux"
}
],
"timestamp": "2022-12-21T00:29:04+01:00",
"expiry": null,
"url": "https://isthereanydeal.com/link/018531a3-cec4-700a-8534-79c6e498959f/"
}
]
},
{"id": "01849783-6a26-7147-ab32-71804ca47e8e",
"deals": [{"shop": {"id": 35,
"name": "GOG"
},
"price": {"amount": 7.99,
"amountInt": 799,
"currency": "USD"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"cut": 80,
"voucher": null,
"storeLow": {"amount": 7.99,
"amountInt": 799,
"currency": "USD"
},
"historyLow": {"amount": 5.99,
"amountInt": 599,
"currency": "USD"
},
"flag": "S",
"drm": [{"id": 1000,
"name": "Drm Free"
}
],
"platforms": [{"id": 1,
"name": "Windows"
},
{"id": 2,
"name": "Mac"
},
{"id": 3,
"name": "Linux"
}
],
"timestamp": "2023-05-13T01:43:45+02:00",
"expiry": null,
"url": "https://isthereanydeal.com/link/0184d8a2-6f10-7284-811a-450d3df4feb1/"
},
{"shop": {"id": 37,
"name": "Humble Store"
},
"price": {"amount": 9.99,
"amountInt": 999,
"currency": "USD"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"cut": 75,
"voucher": null,
"storeLow": {"amount": 9.99,
"amountInt": 999,
"currency": "USD"
},
"historyLow": {"amount": 5.99,
"amountInt": 599,
"currency": "USD"
},
"flag": "S",
"drm": [{"id": 61,
"name": "Steam"
}
],
"platforms": [{"id": 1,
"name": "Windows"
},
{"id": 2,
"name": "Mac"
},
{"id": 3,
"name": "Linux"
}
],
"timestamp": "2023-05-11T22:05:42+02:00",
"expiry": "2023-05-23T19:00:00+02:00",
"url": "https://isthereanydeal.com/link/0184d9c7-79bf-7008-b766-5a2820c8c92b/"
}
]
}
]

games

Game Lookup

Lookup game based on title or Steam appid

Authorizations:

keySecurity

query Parameters

title	string Find game by it's name
appid	number Find game by Steam appid

Responses

Response samples

200
400
default

Content type

application/json

Example

found

Game found

{"found": true,
"game": {"id": "01847884-d7f0-7392-b701-2103ce5b64eb",
"slug": "team-fortress-2",
"title": "Team Fortress 2",
"type": null,
"mature": false
}
}

Game Search

Search for games by title

Authorizations:

keySecurity

query Parameters

title required	string Find games by name
results	number [ 1 .. 100 ] Default: 20 Maximum number of results to return

Responses

Response samples

200
400
default

Content type

application/json

Europa Universalis IV search

[{"id": "01849783-6a26-7147-ab32-71804ca47e8e",
"slug": "europa-universalis-iv",
"title": "Europa Universalis IV",
"type": "game",
"mature": false
},
{"id": "01849783-6740-7240-bf0a-194b4678243b",
"slug": "europa-universalis-iv-dharma",
"title": "Europa Universalis IV: Dharma",
"type": "dlc",
"mature": false
},
{"id": "01849782-b769-715a-a0bb-9467eb5a6fa4",
"slug": "europa-universalis-iv-emperor",
"title": "Europa Universalis IV: Emperor",
"type": "dlc",
"mature": false
},
{"id": "0184c0c4-7e9a-7143-a2a2-460027fabf76",
"slug": "europa-universalis-iv-origins",
"title": "Europa Universalis IV: Origins",
"type": "dlc",
"mature": false
},
{"id": "01849783-74ad-7125-8c6c-f7f14f3cc5b3",
"slug": "europa-universalis-iv-cossacks",
"title": "Europa Universalis IV: Cossacks",
"type": "dlc",
"mature": false
}
]

Game Info

Get basic game information

Authorizations:

keySecurity

query Parameters

id

required

string <uuid>

Game ID

Responses

Response samples

200
400
404
default

Content type

application/json

Europa Universalis IV info

{"id": "018d937f-07fc-72ed-8517-d8e24cb1eb22",
"slug": "europa-universalis-iv",
"title": "Europa Universalis IV",
"type": "game",
"mature": false,
"assets": {"boxart": "https://dbxce1spal1df.cloudfront.net/018d937f-07fc-72ed-8517-d8e24cb1eb22/boxart.jpg",
"banner145": "https://dbxce1spal1df.cloudfront.net/018d937f-07fc-72ed-8517-d8e24cb1eb22/banner145.jpg",
"banner300": "https://dbxce1spal1df.cloudfront.net/018d937f-07fc-72ed-8517-d8e24cb1eb22/banner300.jpg",
"banner400": "https://dbxce1spal1df.cloudfront.net/018d937f-07fc-72ed-8517-d8e24cb1eb22/banner400.jpg",
"banner600": "https://dbxce1spal1df.cloudfront.net/018d937f-07fc-72ed-8517-d8e24cb1eb22/banner600.jpg"
},
"earlyAccess": false,
"achievements": true,
"tradingCards": true,
"appid": 236850,
"tags": ["Grand Strategy",
"Strategy",
"Historical",
"Simulation",
"4X"
],
"releaseDate": "2013-08-13",
"developers": [{"id": 434,
"name": "Paradox Development Studio"
},
{"id": 8188,
"name": "Paradox"
},
{"id": 8765,
"name": "Paradox Development Studio / Paradox Tinto"
},
{"id": 514,
"name": "Paradox Tinto"
}
],
"publishers": [{"id": 84,
"name": "Paradox Interactive"
},
{"id": 16,
"name": "Paradox Interactive AB"
},
{"id": 8188,
"name": "Paradox"
}
],
"reviews": [{"score": 86,
"source": "Steam",
"count": 84184,
"url": "https://store.steampowered.com/app/236850/"
},
{"score": 87,
"source": "Metascore",
"count": 31,
"url": "https://metacritic.com/game/europa-universalis-iv/critic-reviews/?platform=pc"
},
{"score": 87,
"source": "Metacritic User Score",
"count": 1399,
"url": "https://metacritic.com/game/europa-universalis-iv/user-reviews/?platform=pc"
}
],
"stats": {"rank": 529,
"waitlisted": 3368,
"collected": 18718
},
"players": {"recent": 16763,
"day": 16967,
"week": 22451,
"peak": 46940
},
"urls": {"game": "https://isthereanydeal.com/game/europa-universalis-iv/"
}
}

Prices

Get games' prices

Authorizations:

keySecurity

query Parameters

country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
nondeals	boolean Load non-sale prices
vouchers	boolean Allow vouchers in prices
capacity	integer >= 0 How many prices to load per each game, 0 or omit for no limit
shops	Array of integers Example: shops=65,35 List of shop IDs for which you want to load prices

Request Body schema: application/json

List of Game IDs for which to load prices

Array ([ 1 .. 200 ] items)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": "01849782-1017-7389-8de4-c97c587fd7e3",
"deals": [{"shop": {"id": 24,
"name": "GamersGate"
},
"price": {"amount": 5.93,
"amountInt": 593,
"currency": "USD"
},
"regular": {"amount": 21.99,
"amountInt": 2199,
"currency": "USD"
},
"cut": 73,
"voucher": null,
"storeLow": {"amount": 5.93,
"amountInt": 593,
"currency": "USD"
},
"historyLow": {"amount": 3.99,
"amountInt": 399,
"currency": "USD"
},
"flag": "S",
"drm": [{"id": 61,
"name": "Steam"
}
],
"platforms": [{"id": 1,
"name": "Windows"
},
{"id": 2,
"name": "Mac"
}
],
"timestamp": "2023-06-06T21:54:09+02:00",
"expiry": "2023-06-07T23:59:59+02:00",
"url": "https://isthereanydeal.com/link/0184d081-61ab-7036-994c-6e17f1348fe7/"
},
{"shop": {"id": 61,
"name": "Steam"
},
"price": {"amount": 6.59,
"amountInt": 659,
"currency": "USD"
},
"regular": {"amount": 21.99,
"amountInt": 2199,
"currency": "USD"
},
"cut": 70,
"voucher": null,
"storeLow": {"amount": 6.59,
"amountInt": 659,
"currency": "USD"
},
"historyLow": {"amount": 3.99,
"amountInt": 399,
"currency": "USD"
},
"flag": "S",
"drm": [ ],
"platforms": [{"id": 1,
"name": "Windows"
},
{"id": 2,
"name": "Mac"
},
{"id": 3,
"name": "Linux"
}
],
"timestamp": "2022-12-21T00:29:04+01:00",
"expiry": null,
"url": "https://isthereanydeal.com/link/018531a3-cec4-700a-8534-79c6e498959f/"
}
]
},
{"id": "01849783-6a26-7147-ab32-71804ca47e8e",
"deals": [{"shop": {"id": 35,
"name": "GOG"
},
"price": {"amount": 7.99,
"amountInt": 799,
"currency": "USD"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"cut": 80,
"voucher": null,
"storeLow": {"amount": 7.99,
"amountInt": 799,
"currency": "USD"
},
"historyLow": {"amount": 5.99,
"amountInt": 599,
"currency": "USD"
},
"flag": "S",
"drm": [{"id": 1000,
"name": "Drm Free"
}
],
"platforms": [{"id": 1,
"name": "Windows"
},
{"id": 2,
"name": "Mac"
},
{"id": 3,
"name": "Linux"
}
],
"timestamp": "2023-05-13T01:43:45+02:00",
"expiry": null,
"url": "https://isthereanydeal.com/link/0184d8a2-6f10-7284-811a-450d3df4feb1/"
},
{"shop": {"id": 37,
"name": "Humble Store"
},
"price": {"amount": 9.99,
"amountInt": 999,
"currency": "USD"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"cut": 75,
"voucher": null,
"storeLow": {"amount": 9.99,
"amountInt": 999,
"currency": "USD"
},
"historyLow": {"amount": 5.99,
"amountInt": 599,
"currency": "USD"
},
"flag": "S",
"drm": [{"id": 61,
"name": "Steam"
}
],
"platforms": [{"id": 1,
"name": "Windows"
},
{"id": 2,
"name": "Mac"
},
{"id": 3,
"name": "Linux"
}
],
"timestamp": "2023-05-11T22:05:42+02:00",
"expiry": "2023-05-23T19:00:00+02:00",
"url": "https://isthereanydeal.com/link/0184d9c7-79bf-7008-b766-5a2820c8c92b/"
}
]
}
]

History Low

Get historically lowest prices

Authorizations:

keySecurity

query Parameters

country

string = 2 characters

Default: "US"

Two letter country code (ISO 3166-1 alpha-2)

Request Body schema: application/json

List of Game IDs for which to load historical lows

Array ([ 1 .. 200 ] items)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": "01849782-1017-7389-8de4-c97c587fd7e3",
"low": {"shop": {"id": 47,
"name": "MacGameStore"
},
"price": {"amount": 3.99,
"amountInt": 399,
"currency": "USD"
},
"regular": {"amount": 21.99,
"amountInt": 2199,
"currency": "USD"
},
"cut": 82,
"timestamp": "2022-11-27T21:33:36+01:00"
}
},
{"id": "01849783-6a26-7147-ab32-71804ca47e8e",
"low": {"shop": {"id": 47,
"name": "MacGameStore"
},
"price": {"amount": 5.99,
"amountInt": 599,
"currency": "USD"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"cut": 85,
"timestamp": "2022-12-23T03:22:14+01:00"
}
}
]

Store Low

Get historically lowest prices for individual stores

Authorizations:

keySecurity

query Parameters

country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
shops	Array of integers Example: shops=65,35 List of shop IDs

Request Body schema: application/json

List of Game IDs for which to load store lows

Array ([ 1 .. 200 ] items)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": "01849782-1017-7389-8de4-c97c587fd7e3",
"lows": [{"shop": {"id": 13,
"name": "DLGamer"
},
"price": {"amount": 6.6,
"amountInt": 660,
"currency": "USD"
},
"regular": {"amount": 21.99,
"amountInt": 2199,
"currency": "USD"
},
"cut": 70,
"timestamp": "2022-11-29T02:14:37+01:00"
},
{"shop": {"id": 61,
"name": "Steam"
},
"price": {"amount": 6.59,
"amountInt": 659,
"currency": "USD"
},
"regular": {"amount": 21.99,
"amountInt": 2199,
"currency": "USD"
},
"cut": 70,
"timestamp": "2022-12-21T00:29:04+01:00"
}
]
},
{"id": "01849783-6a26-7147-ab32-71804ca47e8e",
"lows": [{"shop": {"id": 13,
"name": "DLGamer"
},
"price": {"amount": 10,
"amountInt": 1000,
"currency": "USD"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"cut": 75,
"timestamp": "2022-11-29T02:14:36+01:00"
},
{"shop": {"id": 61,
"name": "Steam"
},
"price": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"cut": 0,
"timestamp": "2022-12-14T00:28:40+01:00"
}
]
}
]

Bundles including Game

Get all bundles which contain the game

Authorizations:

keySecurity

query Parameters

id required	string <uuid> Game ID
country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
expired	boolean Include expired bundles

Responses

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": 19,
"title": "Rimworld with all Expansions Bundle",
"page": {"id": 8,
"name": "Fanatical"
},
"url": "http://www.jdoqocy.com/click-6305441-13212017?URL=https%3A%2F%2Fwww.fanatical.com%2Fen%2Fbundle%2Frimworld-with-all-expansions",
"isMature": false,
"publish": "2023-07-23T00:36:18+02:00",
"expiry": "2023-07-26T09:00:00+02:00",
"counts": {"games": 4,
"media": 0
},
"tiers": [{"price": {"amount": 79.04,
"amountInt": 7904,
"currency": "EUR"
},
"games": [{"id": "0184bb93-24e6-703e-8ada-7edfc6d71b54",
"slug": "rimworld-biotech",
"title": "RimWorld - Biotech",
"type": "dlc",
"mature": false
},
{"id": "0184bb93-26bf-724e-8e4e-6d0316662a01",
"slug": "rimworld",
"title": "RimWorld",
"type": "game",
"mature": false
},
{"id": "0184bb93-525b-70e7-a50d-50ca8706fef6",
"slug": "rimworld-ideology",
"title": "RimWorld - Ideology",
"type": "dlc",
"mature": false
},
{"id": "0184bb93-57e8-7147-aebf-88778eb3e5b0",
"slug": "rimworld-royalty",
"title": "RimWorld - Royalty",
"type": "dlc",
"mature": false
}
]
}
]
}
]

Price Overview

Get basic price overview for selected games.

For each game current best price will be loaded (optionally, only from selected shops), historical low price (among all covered shops).

Furthermore, result will also contain list of currently active bundles, which contain at least one of the queried games.

Authorizations:

keySecurity

query Parameters

country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
shops	Array of integers Example: shops=65,35 List of shop IDs
vouchers	boolean Default: true Allow vouchers in prices

Request Body schema: application/json

List of Game IDs

Array ([ 1 .. 200 ] items)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

200
400
default

Content type

application/json

Successful response

{"prices": [{"id": "018d937f-12e9-71ca-a5d5-f31985870694",
"current": {"shop": {"id": 61,
"name": "Steam"
},
"price": {"amount": 31.99,
"amountInt": 3199,
"currency": "EUR"
},
"regular": {"amount": 31.99,
"amountInt": 3199,
"currency": "EUR"
},
"cut": 0,
"voucher": null,
"flag": null,
"drm": [ ],
"platforms": [{"id": 1,
"name": "Windows"
},
{"id": 2,
"name": "Mac"
},
{"id": 3,
"name": "Linux"
}
],
"timestamp": "2024-02-11T02:07:53+01:00",
"expiry": null,
"url": "https://itad.link/018d9386-b9c8-71ea-8724-47f829db21bd/"
},
"lowest": {"shop": {"id": 6,
"name": "Fanatical"
},
"price": {"amount": 22.39,
"amountInt": 2239,
"currency": "EUR"
},
"regular": {"amount": 31.99,
"amountInt": 3199,
"currency": "EUR"
},
"cut": 30,
"timestamp": "2023-03-08T17:35:17+01:00"
},
"bundled": 1,
"urls": {"game": "https://isthereanydeal.com/game/id:018d937f-12e9-71ca-a5d5-f31985870694/"
}
}
],
"bundles": [{"id": 11631,
"title": "Rimworld with all Expansions Bundle",
"page": {"id": 8,
"name": "Fanatical",
"shopId": 6
},
"url": "https://www.jdoqocy.com/click-6305441-13212017?URL=https%3A%2F%2Fwww.fanatical.com%2Fen%2Fbundle%2Frimworld-with-all-expansions",
"details": "https://isthereanydeal.com/bundles/11631/",
"isMature": false,
"publish": "2024-03-04T19:00:00+01:00",
"expiry": "2024-03-22T00:59:46+01:00",
"counts": {"games": 4,
"media": 1
},
"tiers": [{"price": {"amount": 87.96,
"amountInt": 8796,
"currency": "USD"
},
"games": [{"id": "018d937f-12e9-71ca-a5d5-f31985870694",
"slug": "rimworld",
"title": "RimWorld",
"type": "game",
"mature": false
},
{"id": "018d937f-3e88-718b-b99d-9a45bb69be55",
"slug": "rimworld-royalty",
"title": "RimWorld - Royalty",
"type": "dlc",
"mature": false
},
{"id": "018d937f-5256-73e1-bba6-66fd3f4d9cd7",
"slug": "rimworld-ideology",
"title": "RimWorld - Ideology",
"type": "dlc",
"mature": false
},
{"id": "018d937f-65f0-70d3-83fe-71fac1505a13",
"slug": "rimworld-biotech",
"title": "RimWorld - Biotech",
"type": "dlc",
"mature": false
}
]
}
]
}
]
}

History log

Get log of historical prices

Authorizations:

keySecurity

query Parameters

id required	string <uuid> Game ID
country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
shops	Array of integers Example: shops=65,35 List of shop IDs
since	string <date-time> Load only price changes after this date. By default, only last 3 months are loaded

Responses

Response samples

200
400
default

Content type

application/json

Successful response

[{"timestamp": "2022-12-27T11:21:08+01:00",
"shop": {"id": 61,
"name": "Steam"
},
"deal": {"price": {"amount": 9.99,
"amountInt": 999,
"currency": "EUR"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "EUR"
},
"cut": 75
}
},
{"timestamp": "2022-12-14T00:12:29+01:00",
"shop": {"id": 61,
"name": "Steam"
},
"deal": {"price": {"amount": 39.99,
"amountInt": 3999,
"currency": "EUR"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "EUR"
},
"cut": 0
}
}
]

Lookup Shop's Game IDs

Lookup shop's game IDs by IsThereAnyDeal game IDs

Authorizations:

NonekeySecurity

path Parameters

shopId

required

number

Request Body schema: application/json

List of game IDs

Array (non-empty)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]

Response samples

200
400
default

Content type

application/json

{"018d95bc-fe96-73e6-a9f7-10afc28c0c03": ["bundle/27508"
],
"018d937f-6671-7056-b419-aac8a69a625e": ["bundle/32380",
"bundle/28796"
],
"018d937f-42c6-70a5-a29b-9d8c2e0f7b84": ["app/1336490",
"sub/467072"
],
"018d937f-6128-7151-8d2e-b4a9ad2e1ce8": ["sub/637996",
"app/1777620",
"sub/752476"
]
}

Lookup Game IDs

Lookup IsThereAnyDeal's game IDs by shop's game IDs

Authorizations:

NonekeySecurity

path Parameters

shopId

required

number

Request Body schema: application/json

List of shop's game IDs

Array (non-empty)

string

Responses

Request samples

Payload

Content type

application/json

["app/220"
]

Response samples

200
400
default

Content type

application/json

{"bundle/27508": "018d95bc-fe96-73e6-a9f7-10afc28c0c03",
"bundle/28796": "018d937f-6671-7056-b419-aac8a69a625e",
"sub/467072": "018d937f-42c6-70a5-a29b-9d8c2e0f7b84",
"sub/752476": "018d937f-6128-7151-8d2e-b4a9ad2e1ce8",
"sub/137730": "018d937f-6ee4-73f5-858c-2fde3407462f",
"app/137730": null,
"bundle/33608": "018d937f-7596-706f-b75d-834d76172237"
}

history

History Low

Get historically lowest prices

Authorizations:

keySecurity

query Parameters

country

string = 2 characters

Default: "US"

Two letter country code (ISO 3166-1 alpha-2)

Request Body schema: application/json

List of Game IDs for which to load historical lows

Array ([ 1 .. 200 ] items)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": "01849782-1017-7389-8de4-c97c587fd7e3",
"low": {"shop": {"id": 47,
"name": "MacGameStore"
},
"price": {"amount": 3.99,
"amountInt": 399,
"currency": "USD"
},
"regular": {"amount": 21.99,
"amountInt": 2199,
"currency": "USD"
},
"cut": 82,
"timestamp": "2022-11-27T21:33:36+01:00"
}
},
{"id": "01849783-6a26-7147-ab32-71804ca47e8e",
"low": {"shop": {"id": 47,
"name": "MacGameStore"
},
"price": {"amount": 5.99,
"amountInt": 599,
"currency": "USD"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"cut": 85,
"timestamp": "2022-12-23T03:22:14+01:00"
}
}
]

Store Low

Get historically lowest prices for individual stores

Authorizations:

keySecurity

query Parameters

country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
shops	Array of integers Example: shops=65,35 List of shop IDs

Request Body schema: application/json

List of Game IDs for which to load store lows

Array ([ 1 .. 200 ] items)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": "01849782-1017-7389-8de4-c97c587fd7e3",
"lows": [{"shop": {"id": 13,
"name": "DLGamer"
},
"price": {"amount": 6.6,
"amountInt": 660,
"currency": "USD"
},
"regular": {"amount": 21.99,
"amountInt": 2199,
"currency": "USD"
},
"cut": 70,
"timestamp": "2022-11-29T02:14:37+01:00"
},
{"shop": {"id": 61,
"name": "Steam"
},
"price": {"amount": 6.59,
"amountInt": 659,
"currency": "USD"
},
"regular": {"amount": 21.99,
"amountInt": 2199,
"currency": "USD"
},
"cut": 70,
"timestamp": "2022-12-21T00:29:04+01:00"
}
]
},
{"id": "01849783-6a26-7147-ab32-71804ca47e8e",
"lows": [{"shop": {"id": 13,
"name": "DLGamer"
},
"price": {"amount": 10,
"amountInt": 1000,
"currency": "USD"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"cut": 75,
"timestamp": "2022-11-29T02:14:36+01:00"
},
{"shop": {"id": 61,
"name": "Steam"
},
"price": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "USD"
},
"cut": 0,
"timestamp": "2022-12-14T00:28:40+01:00"
}
]
}
]

History log

Get log of historical prices

Authorizations:

keySecurity

query Parameters

id required	string <uuid> Game ID
country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
shops	Array of integers Example: shops=65,35 List of shop IDs
since	string <date-time> Load only price changes after this date. By default, only last 3 months are loaded

Responses

Response samples

200
400
default

Content type

application/json

Successful response

[{"timestamp": "2022-12-27T11:21:08+01:00",
"shop": {"id": 61,
"name": "Steam"
},
"deal": {"price": {"amount": 9.99,
"amountInt": 999,
"currency": "EUR"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "EUR"
},
"cut": 75
}
},
{"timestamp": "2022-12-14T00:12:29+01:00",
"shop": {"id": 61,
"name": "Steam"
},
"deal": {"price": {"amount": 39.99,
"amountInt": 3999,
"currency": "EUR"
},
"regular": {"amount": 39.99,
"amountInt": 3999,
"currency": "EUR"
},
"cut": 0
}
}
]

bundles

Bundles including Game

Get all bundles which contain the game

Authorizations:

keySecurity

query Parameters

id required	string <uuid> Game ID
country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
expired	boolean Include expired bundles

Responses

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": 19,
"title": "Rimworld with all Expansions Bundle",
"page": {"id": 8,
"name": "Fanatical"
},
"url": "http://www.jdoqocy.com/click-6305441-13212017?URL=https%3A%2F%2Fwww.fanatical.com%2Fen%2Fbundle%2Frimworld-with-all-expansions",
"isMature": false,
"publish": "2023-07-23T00:36:18+02:00",
"expiry": "2023-07-26T09:00:00+02:00",
"counts": {"games": 4,
"media": 0
},
"tiers": [{"price": {"amount": 79.04,
"amountInt": 7904,
"currency": "EUR"
},
"games": [{"id": "0184bb93-24e6-703e-8ada-7edfc6d71b54",
"slug": "rimworld-biotech",
"title": "RimWorld - Biotech",
"type": "dlc",
"mature": false
},
{"id": "0184bb93-26bf-724e-8e4e-6d0316662a01",
"slug": "rimworld",
"title": "RimWorld",
"type": "game",
"mature": false
},
{"id": "0184bb93-525b-70e7-a50d-50ca8706fef6",
"slug": "rimworld-ideology",
"title": "RimWorld - Ideology",
"type": "dlc",
"mature": false
},
{"id": "0184bb93-57e8-7147-aebf-88778eb3e5b0",
"slug": "rimworld-royalty",
"title": "RimWorld - Royalty",
"type": "dlc",
"mature": false
}
]
}
]
}
]

user

Games in Waitlist

Get games in user's Waitlist

Authorizations:

oauthSecurity

Responses

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": "01846e7e-7e96-71fb-bf16-6979fa211638",
"slug": "ghost-master",
"title": "Ghost Master®",
"type": "game",
"mature": false
},
{"id": "01846e7e-816f-7226-bb91-17ba0a50f081",
"slug": "geometry-wars-retro-evolved",
"title": "Geometry Wars: Retro Evolved",
"type": null,
"mature": false
},
{"id": "01846e7e-84f8-7314-94eb-6bff48d886f8",
"slug": "the-ship-single-player",
"title": "The Ship: Single Player",
"type": null,
"mature": false
}
]

Add to Waitlist

Add games to user's Waitlist

Authorizations:

oauthSecurity

Request Body schema: application/json

List of Game IDs

Array (non-empty)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

400
default

Content type

application/json

{"status_code": 0,
"reason_phrase": "string"
}

Delete from Waitlist

Delete games from user's Waitlist

Authorizations:

oauthSecurity

Request Body schema: application/json

List of Game IDs

Array (non-empty)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

400
default

Content type

application/json

{"status_code": 0,
"reason_phrase": "string"
}

Games in Collection

Get games in user's Collection

Authorizations:

oauthSecurity

Responses

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": "01846e7e-7e96-71fb-bf16-6979fa211638",
"slug": "ghost-master",
"title": "Ghost Master®",
"type": "game",
"mature": false
},
{"id": "01846e7e-816f-7226-bb91-17ba0a50f081",
"slug": "geometry-wars-retro-evolved",
"title": "Geometry Wars: Retro Evolved",
"type": null,
"mature": false
},
{"id": "01846e7e-84f8-7314-94eb-6bff48d886f8",
"slug": "the-ship-single-player",
"title": "The Ship: Single Player",
"type": null,
"mature": false
}
]

Add to Collection

Add games to user's Collection

Authorizations:

oauthSecurity

Request Body schema: application/json

List of Game IDs

Array (non-empty)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

400
default

Content type

application/json

{"status_code": 0,
"reason_phrase": "string"
}

Delete from Collection

Delete games from user's Collection

Authorizations:

oauthSecurity

Request Body schema: application/json

List of Game IDs

Array (non-empty)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

400
default

Content type

application/json

{"status_code": 0,
"reason_phrase": "string"
}

User Info

Get user info, currently just a username

Authorizations:

oauthSecurity

Responses

Response samples

200
400
default

Content type

application/json

{"username": "string"
}

waitlist

Games in Waitlist

Get games in user's Waitlist

Authorizations:

oauthSecurity

Responses

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": "01846e7e-7e96-71fb-bf16-6979fa211638",
"slug": "ghost-master",
"title": "Ghost Master®",
"type": "game",
"mature": false
},
{"id": "01846e7e-816f-7226-bb91-17ba0a50f081",
"slug": "geometry-wars-retro-evolved",
"title": "Geometry Wars: Retro Evolved",
"type": null,
"mature": false
},
{"id": "01846e7e-84f8-7314-94eb-6bff48d886f8",
"slug": "the-ship-single-player",
"title": "The Ship: Single Player",
"type": null,
"mature": false
}
]

Add to Waitlist

Add games to user's Waitlist

Authorizations:

oauthSecurity

Request Body schema: application/json

List of Game IDs

Array (non-empty)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

400
default

Content type

application/json

{"status_code": 0,
"reason_phrase": "string"
}

Delete from Waitlist

Delete games from user's Waitlist

Authorizations:

oauthSecurity

Request Body schema: application/json

List of Game IDs

Array (non-empty)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

400
default

Content type

application/json

{"status_code": 0,
"reason_phrase": "string"
}

Waitlist Stats

Get Waitlist statistics for a game

Note: stats do not take into consideration users' regions. If they have set their price limit to be a historical low, stats will be computed for all users as if they were in the region you specify

Authorizations:

keySecurity

query Parameters

id required	string <uuid> Game ID
country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
bucket_price	integer >= 0 Default: 5 Price bucket size
bucket_cut	integer >= 0 Default: 5 Cut bucket size

Responses

Response samples

200
400
default

Content type

application/json

{"count": 0,
"price": {"currency": "str",
"any": 0,
"average": 0,
"buckets": [{"bucket": 0,
"count": 0,
"percentile": 100
}
]
},
"cut": {"average": 0,
"buckets": [{"bucket": 0,
"count": 0,
"percentile": 100
}
]
}
}

Most Waitlisted

Get list of most Waitlisted games

Authorizations:

keySecurity

query Parameters

offset	integer >= 0 Default: 0
limit	integer [ 1 .. 500 ] Default: 20

Responses

Response samples

200
400
default

Content type

application/json

[{"position": 1,
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"slug": "string",
"title": "string",
"type": "game",
"mature": true,
"count": 0
}
]

collection

Games in Collection

Get games in user's Collection

Authorizations:

oauthSecurity

Responses

Response samples

200
400
default

Content type

application/json

Successful response

[{"id": "01846e7e-7e96-71fb-bf16-6979fa211638",
"slug": "ghost-master",
"title": "Ghost Master®",
"type": "game",
"mature": false
},
{"id": "01846e7e-816f-7226-bb91-17ba0a50f081",
"slug": "geometry-wars-retro-evolved",
"title": "Geometry Wars: Retro Evolved",
"type": null,
"mature": false
},
{"id": "01846e7e-84f8-7314-94eb-6bff48d886f8",
"slug": "the-ship-single-player",
"title": "The Ship: Single Player",
"type": null,
"mature": false
}
]

Add to Collection

Add games to user's Collection

Authorizations:

oauthSecurity

Request Body schema: application/json

List of Game IDs

Array (non-empty)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

400
default

Content type

application/json

{"status_code": 0,
"reason_phrase": "string"
}

Delete from Collection

Delete games from user's Collection

Authorizations:

oauthSecurity

Request Body schema: application/json

List of Game IDs

Array (non-empty)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["01849783-6a26-7147-ab32-71804ca47e8e",
"01849782-1017-7389-8de4-c97c587fd7e3"
]

Response samples

400
default

Content type

application/json

{"status_code": 0,
"reason_phrase": "string"
}

Most Collected

Get list of most Collected games

Authorizations:

keySecurity

query Parameters

offset	integer >= 0 Default: 0
limit	integer [ 1 .. 500 ] Default: 20

Responses

Response samples

200
400
default

Content type

application/json

[{"position": 1,
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"slug": "string",
"title": "string",
"type": "game",
"mature": true,
"count": 0
}
]

stats

Waitlist Stats

Get Waitlist statistics for a game

Note: stats do not take into consideration users' regions. If they have set their price limit to be a historical low, stats will be computed for all users as if they were in the region you specify

Authorizations:

keySecurity

query Parameters

id required	string <uuid> Game ID
country	string = 2 characters Default: "US" Two letter country code (ISO 3166-1 alpha-2)
bucket_price	integer >= 0 Default: 5 Price bucket size
bucket_cut	integer >= 0 Default: 5 Cut bucket size

Responses

Response samples

200
400
default

Content type

application/json

{"count": 0,
"price": {"currency": "str",
"any": 0,
"average": 0,
"buckets": [{"bucket": 0,
"count": 0,
"percentile": 100
}
]
},
"cut": {"average": 0,
"buckets": [{"bucket": 0,
"count": 0,
"percentile": 100
}
]
}
}

Most Waitlisted

Get list of most Waitlisted games

Authorizations:

keySecurity

query Parameters

offset	integer >= 0 Default: 0
limit	integer [ 1 .. 500 ] Default: 20

Responses

Response samples

200
400
default

Content type

application/json

[{"position": 1,
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"slug": "string",
"title": "string",
"type": "game",
"mature": true,
"count": 0
}
]

Most Collected

Get list of most Collected games

Authorizations:

keySecurity

query Parameters

offset	integer >= 0 Default: 0
limit	integer [ 1 .. 500 ] Default: 20

Responses

Response samples

200
400
default

Content type

application/json

[{"position": 1,
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"slug": "string",
"title": "string",
"type": "game",
"mature": true,
"count": 0
}
]

Most Popular

Get list of most popular games. Popularity for each game is computed as Waitlisted count + Collected count.

Authorizations:

keySecurity

query Parameters

offset	integer >= 0 Default: 0
limit	integer [ 1 .. 500 ] Default: 20

Responses

Response samples

200
400
default

Content type

application/json

[{"position": 1,
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"slug": "string",
"title": "string",
"type": "game",
"mature": true,
"count": 0
}
]

unstable

Lookup Shop's Game IDs

Lookup shop's game IDs by IsThereAnyDeal game IDs

Authorizations:

NonekeySecurity

path Parameters

shopId

required

number

Request Body schema: application/json

List of game IDs

Array (non-empty)

string <uuid>

Responses

Request samples

Payload

Content type

application/json

["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]

Response samples

200
400
default

Content type

application/json

{"018d95bc-fe96-73e6-a9f7-10afc28c0c03": ["bundle/27508"
],
"018d937f-6671-7056-b419-aac8a69a625e": ["bundle/32380",
"bundle/28796"
],
"018d937f-42c6-70a5-a29b-9d8c2e0f7b84": ["app/1336490",
"sub/467072"
],
"018d937f-6128-7151-8d2e-b4a9ad2e1ce8": ["sub/637996",
"app/1777620",
"sub/752476"
]
}

Lookup Game IDs

Lookup IsThereAnyDeal's game IDs by shop's game IDs

Authorizations:

NonekeySecurity

path Parameters

shopId

required

number

Request Body schema: application/json

List of shop's game IDs

Array (non-empty)

string

Responses

Request samples

Payload

Content type

application/json

["app/220"
]

Response samples

200
400
default

Content type

application/json

{"bundle/27508": "018d95bc-fe96-73e6-a9f7-10afc28c0c03",
"bundle/28796": "018d937f-6671-7056-b419-aac8a69a625e",
"sub/467072": "018d937f-42c6-70a5-a29b-9d8c2e0f7b84",
"sub/752476": "018d937f-6128-7151-8d2e-b4a9ad2e1ce8",
"sub/137730": "018d937f-6ee4-73f5-858c-2fde3407462f",
"app/137730": null,
"bundle/33608": "018d937f-7596-706f-b75d-834d76172237"
}

internal

Early Access Games

Returns list of Steam appids, which are currently considered to be early in early access

Authorizations:

keySecurity

Responses

Response samples

200
400
default

Content type

application/json

[0
]

Number of Players Statistics

Authorizations:

keySecurity

query Parameters

appid

required

number

Responses

Response samples

200
400
default

Content type

application/json

{"current": 0,
"day": 0,
"peak": 0
}

HowLongToBeat Overview

Authorizations:

keySecurity

query Parameters

appid

required

number

Responses

Response samples

200
400
default

Content type

application/json

{"id": 0,
"main": { },
"extra": { },
"complete": { }
}

Reviews Score

Returns Metacritic user reviews overview and OpenCritic overview for a given game

Authorizations:

keySecurity

query Parameters

appid

required

number

Responses

Response samples

200
400
default

Content type

application/json

{"metauser": {"score": 0,
"verdict": "string",
"url": "http://example.com"
},
"opencritic": {"score": 0,
"verdict": "string",
"url": "http://example.com"
}
}

Conversion Rates

Authorizations:

keySecurity

Responses

Response samples

200
400
default

Content type

application/json

[{"from": "string",
"to": "string",
"rate": 0
}
]

Current stream of Twitch channel

Authorizations:

keySecurity

query Parameters

channel

required

string

Responses

Response samples

200
400
default

Content type

application/json

Example

Players Statistics Response

{"user_name": "string",
"title": "string",
"thumbnail_url": "string",
"viewer_count": 0,
"game": "string"
}