Мы всегда хотели сделать Hot.Game домом для ваших игр. Но дом превращается в тюрьму, если у вас нет возможности его покинуть в любой момент. Именно поэтому мы решили предоставить публичное бесплатное API для всех наших пользователей. Используя его, вы можете автоматически работать с каталогом: выгрузить все ваши коллекции, подписки и избранные игры в удобном машинночитаемом формате JSON.
Но это, конечно же, не все. Также мы предоставляем несколько удобных методов для энтузиастов, которым нужна информация о лучших ценах на игры с разбивкой по регионам. Она будет полезна для многих, кто хочет создать полезные инструменты для геймеров.
Также на этой странице вы найдете информацию о том, как интегрировать ваш магазин с каталогом Hot.Game и о платных опциях API.
На данный момент многие API-методы доступны публично, без необходимости всякой авторизации или получения ключей/токенов доступа. Мы надеемся это сохранить в будущем, но если будут злоупотребления, нам придется сделать доступ только по предварительной регистрации.
Авторизация для методов, которые требуют ее, не предусмотрена в API. Таким образом такие методы на данный момент подходят к использованию только в браузерных расширениях и букмарклетах. В дальнейшем мы планируем добавить возможность авторизации пользователя в каком-то виде именно через API.
Параметры задаются в виде URL-параметров (query string), если иное не указано в описании метода и параметров (многие параметры задаются как непосредственно часть пути). Квадратные скобки в шаблонах означают необязательную часть ссылки.
Наведем пример авторизованного запроса. Напомним, они возможны только в браузерных расширениях или букмарклетах. В случае расширений, этот код должен быть исполнен в background-контексте расширения или в content-контексте страницы Hot.Game, когда пользователь авторизован.
async function fetchHotGameApi(url) {
try {
const r = await fetch(url, {
method: 'GET',
credentials: 'include',
});
if (!r.ok) {
return {isError: true, status: r.status, message: `HTTP error ${r.status}`};
}
return await r.json();
} catch (e) {
console.error('Some error occured', e);
return { isError: true, error: e };
}
}
fetchHotGameApi('https://api.hot.game/user/my-games').then(console.log);
Этот метод позволяет получить основную информацию: текущую версию, дату последнего обновления, ссылку на информацию о нем (если был соответсвующий пост в нашем блоге).
Также важным полем является nextAPIIncompatibleUpdate, которое может содержать либо false значение (в случае, если нет заплинированных несовместимых изменений в API), либо содержать объект с информацией о таком обновлении. Разумеется, мы постараемся, чтобы таких обновлений было как можно меньше. Но если вы не хотите вручную отслеживать наши Dev-репорты – это отличный способ настроить автоматическую проверку и оповещения о критических изменениях.
{
"title": "Hot.Game API",
"description": "This is API of Hot.Game Service.",
"version": "0.0.1",
"lastAPIUpdateDate": "25 Nov 2025 22:21:34 GMT",
"lastAPIUpdateDateTimestamp": 1764109294,
"lastUpdateDetails": "link_on_post_on_hgn",
"nextAPIIncompatibleUpdate": {
"version": "0.0.2",
"details": "link_on_post_on_hgn",
"plannedUpdateDate": "26 Nov 2025 22:21:34 GMT",
"plannedUpdateDateTimestamp": 1764195694
},
"documentation": "https://hot.game/api",
"support": "support@hot-game.info"
}
Этот метод позволяет получить список ВСЕХ игр в нашем каталоге. Информации о каждой игре немного, но затем вы можете воспользоваться другими методами для получения более детальной информации о нужных вам играх.
[
{
"HGID":4783,
"title":"Evan\u0027s Remains",
"slug":"Evans-Remains",
"hg_link":"https:\/\/hot.game\/game\/Evans-Remains"
},
{
"HGID":6408,
"title":"Doom 3: VR Edition",
"slug":"Doom-3-VR-Edition",
"hg_link":"https:\/\/hot.game\/game\/Doom-3-VR-Edition"
},
...
]
https://hot.game/game/{game-slug}
Главная информация, доступная в этом методе, это, конечно же, информация о минимальной цене на игру с разбивкой по регионам и платформам.
В поле converted_price (содержится в каждой цене), находится массив с информацией о конвертированной цене в вашу текущую валюту. Алгоритм определения текущей валюты довольно запутан. Если вы хотите гарантировать конкретную валюту, вам лучше указывать параметр currency.
Мы не рекомендуем полагаться на поле HGID, рассматривается возможность его удаления в будущем и, возможную, замену на более универсальный идентификатор.
{
"HGID": 5805,
"title": "Hogwarts Legacy",
"alt_title": "Хогвартс Наследие",
"slug": "Hogwarts-Legacy",
"release_date": "2023-02-10",
"min_prices_by_region": {
"all": [
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 445,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 445
},
"percent_discount": 87,
"platform": "windows",
"region": "Все регионы",
"region_code_name": "all",
"region_short_name": "ВСЕ"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 4339,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 4339
},
"percent_discount": 30,
"platform": "nintendo_switch",
"region": "Все регионы",
"region_code_name": "all",
"region_short_name": "ВСЕ"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 710,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 710
},
"percent_discount": 89,
"platform": "ps_4",
"region": "Все регионы",
"region_code_name": "all",
"region_short_name": "ВСЕ"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 6499,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 6499
},
"percent_discount": 0,
"platform": "nintendo_switch_2",
"region": "Все регионы",
"region_code_name": "all",
"region_short_name": "ВСЕ"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 502,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 502
},
"percent_discount": 93,
"platform": "xbox_sx",
"region": "Все регионы",
"region_code_name": "all",
"region_short_name": "ВСЕ"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 828,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 828
},
"percent_discount": 86,
"platform": "ps_5",
"region": "Все регионы",
"region_code_name": "all",
"region_short_name": "ВСЕ"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 710,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 710
},
"percent_discount": 89,
"platform": "xbox_one",
"region": "Все регионы",
"region_code_name": "all",
"region_short_name": "ВСЕ"
}
],
"ua": [
{
"currency": "UAH",
"currency_symbol": "₴",
"price": 239,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 445
},
"percent_discount": 85,
"platform": "windows",
"region": "Украина",
"region_code_name": "ua",
"region_short_name": "UA"
},
{
"currency": "UAH",
"currency_symbol": "₴",
"price": 269,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 502
},
"percent_discount": 93,
"platform": "xbox_sx",
"region": "Украина",
"region_code_name": "ua",
"region_short_name": "UA"
},
{
"currency": "UAH",
"currency_symbol": "₴",
"price": 2438,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 4544
},
"percent_discount": 29,
"platform": "xbox_one",
"region": "Украина",
"region_code_name": "ua",
"region_short_name": "UA"
}
],
"cis": [
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 524,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 524
},
"percent_discount": 85,
"platform": "windows",
"region": "СНГ",
"region_code_name": "cis",
"region_short_name": "СНГ"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 1108,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 1108
},
"percent_discount": 84,
"platform": "xbox_sx",
"region": "СНГ",
"region_code_name": "cis",
"region_short_name": "СНГ"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 4544,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 4544
},
"percent_discount": 29,
"platform": "xbox_one",
"region": "СНГ",
"region_code_name": "cis",
"region_short_name": "СНГ"
}
],
"ww": [
{
"currency": "USD",
"currency_symbol": "$",
"price": 8.99,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 710
},
"percent_discount": 85,
"platform": "windows",
"region": "Без региональных ограничений (Region free)",
"region_code_name": "ww",
"region_short_name": "Мир"
},
{
"currency": "USD",
"currency_symbol": "$",
"price": 8.99,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 710
},
"percent_discount": 85,
"platform": "ps_4",
"region": "Без региональных ограничений (Region free)",
"region_code_name": "ww",
"region_short_name": "Мир"
},
{
"currency": "USD",
"currency_symbol": "$",
"price": 10.49,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 828
},
"percent_discount": 88,
"platform": "xbox_sx",
"region": "Без региональных ограничений (Region free)",
"region_code_name": "ww",
"region_short_name": "Мир"
},
{
"currency": "USD",
"currency_symbol": "$",
"price": 10.49,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 828
},
"percent_discount": 85,
"platform": "ps_5",
"region": "Без региональных ограничений (Region free)",
"region_code_name": "ww",
"region_short_name": "Мир"
},
{
"currency": "USD",
"currency_symbol": "$",
"price": 8.99,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 710
},
"percent_discount": 89,
"platform": "xbox_one",
"region": "Без региональных ограничений (Region free)",
"region_code_name": "ww",
"region_short_name": "Мир"
}
],
"ru": [
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 4339,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 4339
},
"percent_discount": 30,
"platform": "nintendo_switch",
"region": "Россия",
"region_code_name": "ru",
"region_short_name": "RU"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 2399,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 2399
},
"percent_discount": 63,
"platform": "ps_4",
"region": "Россия",
"region_code_name": "ru",
"region_short_name": "RU"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 6499,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 6499
},
"percent_discount": 0,
"platform": "nintendo_switch_2",
"region": "Россия",
"region_code_name": "ru",
"region_short_name": "RU"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 2899,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 2899
},
"percent_discount": 52,
"platform": "ps_5",
"region": "Россия",
"region_code_name": "ru",
"region_short_name": "RU"
},
{
"currency": "RUB",
"currency_symbol": "₽",
"price": 5999,
"converted_price": {
"currency": "RUB",
"currency_symbol": "₽",
"price": 5999
},
"percent_discount": 0,
"platform": "xbox_one",
"region": "Россия",
"region_code_name": "ru",
"region_short_name": "RU"
}
]
},
"hg_link": "https://hot.game/game/Hogwarts-Legacy"
}
https://hot.game/game/{game-slug}
"Информация о моей игре" – это информация о ваших "взаимоотношениях" с конкретной игрой. Добавили ли вы ее в избранное (поле saved) или отслеживаемое (поле subscription), выставили ли вы ей оценку (поле rating[vote]) и добавили ли ее в какие-то из ваших коллекций (поле collections).
{
"saved": true,
"subscription": {
"new_games": false,
"region": "all",
"currency": "UAH",
"platforms": [
"windows"
]
},
"rating": {
"value":2.8,
"vote": 4,
"max": 4,
"min": 1
},
"collections": [
{
"slug": "382d97",
"name": "Это на Новый Год 🎄"
}
]
}
Список ваших игр, выводится по 100 игр на страницу.
{
"my_games": [
{
"title": "Gothic 1 Remake",
"slug": "Gothic-Remake",
"hg_link": "https://hot.game/game/Gothic-Remake"
},
...
],
"page": 2,
"page_size": 100,
"total_my_games_number": 382
}
Список ваших коллекций со всей необходимой информацией. Поле type содержит значение тип коллекции.
{
"collections": [
{
"slug": "a01d9c",
"name": "На позже",
"public": false,
"exclude_from_filters": false,
"games_count": 2,
"type": null
},
{
"slug": "0c9976",
"name": "Не играл",
"public": false,
"exclude_from_filters": false,
"games_count": 531,
"type": "not_played"
},
{
"slug": "713345",
"name": "Не интересует",
"public": false,
"exclude_from_filters": false,
"games_count": 23,
"type": "not_interested"
},
{
"slug": "5e5c13",
"name": "Самая лучшая коллекция в мире",
"public": true,
"exclude_from_filters": false,
"games_count": 1,
"type": null
},
{
"slug": "7b58e9",
"name": "Хочу поиграть",
"public": false,
"exclude_from_filters": false,
"games_count": 44,
"type": "want_to_play"
},
{
"slug": "382d97",
"name": "Это на Новый Год 🎄",
"public": true,
"exclude_from_filters": false,
"games_count": 9,
"type": null
}
]
}
https://hot.game/collection/{collection-slug}
Информация о коллекции. Игры выводятся по 100 игр на страницу. Если коллекция непублична (поле public – false), вам понадобится авторизация.
{
"slug": "382d97",
"name": "Это на Новый Год 🎄",
"public": true,
"exclude_from_filters": false,
"games_count": 9,
"type": null,
"page": 1,
"page_size": 100,
"games_in_collection": [
{
"HGID": 5805,
"title": "Hogwarts Legacy",
"slug": "Hogwarts-Legacy",
"hg_link": "https://hot.game/game/Hogwarts-Legacy"
},
{
"HGID": 3,
"title": "Grand Theft Auto V",
"slug": "grand-theft-auto-5",
"hg_link": "https://hot.game/game/grand-theft-auto-5"
},
{
"HGID": 3595,
"title": "S.T.A.L.K.E.R. 2: Heart of Chornobyl",
"slug": "STALKER-2-Heart-of-Chernobyl",
"hg_link": "https://hot.game/game/STALKER-2-Heart-of-Chernobyl"
},
{
"HGID": 2496,
"title": "Baldur's Gate III",
"slug": "Baldurs-Gate-3",
"hg_link": "https://hot.game/game/Baldurs-Gate-3"
},
{
"HGID": 9798,
"title": "Grand Theft Auto VI",
"slug": "Grand-Theft-Auto-VI",
"hg_link": "https://hot.game/game/Grand-Theft-Auto-VI"
},
{
"HGID": 9498,
"title": "Indiana Jones and the Great Circle",
"slug": "Indiana-Jones-and-the-Great-Circle",
"hg_link": "https://hot.game/game/Indiana-Jones-and-the-Great-Circle"
},
{
"HGID": 71,
"title": "The Witcher 3: Wild Hunt",
"slug": "the-wtcher-3-wild-hunt",
"hg_link": "https://hot.game/game/the-wtcher-3-wild-hunt"
},
{
"HGID": 9877,
"title": "Mafia: The Old Country",
"slug": "Mafia-The-Old-Country",
"hg_link": "https://hot.game/game/Mafia-The-Old-Country"
},
{
"HGID": 9879,
"title": "Alkahest",
"slug": "Alkahest",
"hg_link": "https://hot.game/game/Alkahest"
}
]
}
Если вам недостаточно предоставляемых публично методов, вы можете обратиться в нашу поддержку с запросом о расширенном доступе или уникальном функционале. Если у вас будет мелкая просьба, которую легко будет реализовать, мы будем рады просто помочь вам.
Но если вас интересуют какие-то большие объемы информации, особенно ценные данные из нашего каталога или долгосрочная поддержка (в общем и целом, если вы хотите использовать API для создания коммерческого проекта), то получение доступа к такому API будет платным на договорной основе. Ориентировочная цена: $20-$100 в месяц.
Если вы владеете магазином (или являетесь его представителем) и хотите чтобы ваши предложения отображались в нашем каталоге – напишите, пожалуйста, в нашу поддержку любым удобным для вас способом. Мы сможем обсудить более детально условия подключения и поможем с любыми техническими вопросами.
Магазины добавляются в каталог только после предварительной проверки администрацией. Точные требования и проверки мы не называем в целях безопасности. Но в общем и целом, ваш магазин должен быть надежным (не мошенническим), а качество услуг должно быть не ниже удовлетворительного уровня (имеется ввиду скорость ответа поддержки, частота ошибок и т.д.).
Hot.Game поддерживает 3 способа интеграции с магазинами (парсинга данных): постраничный HTML-парсер (legacy, сохраняется для нескольких старых магазинов, новые не добавляются), работа с API (в основном для официальных магазинов при системах активации), парсер XML-фидов и JSON-фидов (главный и самый эффективный способ).
...
<response>
...
<game>
<title>Assassin's Creed: Syndicate</title>
<url>link_to_item_in_shop</url>
<price>487.00</price>
<available>1</available>
<region>Ukraine, Russia + CIS</region>
<activation>Uplay</activation>
<platform>windows</platform>
<version>key</version>
</game>
<game>
<title>Assassin's Creed: Unity</title>
<url>link_to_item_in_shop</url>
<price>453.00</price>
<available>1</available>
<region>Region Free</region>
<activation>Uplay</activation>
<platform>windows</platform>
<version>key</version>
</game>
<game>
<title>Assetto Corsa - Ultimate Edition</title>
<url>link_to_item_in_shop</url>
<price>681.00</price>
<available>0</available>
<region>Russia + CIS (excluding Azerbaijan and Tajikistan)</region>
<activation>Steam</activation>
<platform>windows</platform>
<version>key</version>
</game>
...
</response>
...
[
...
{
"title": "Assassin's Creed: Syndicate",
"url": "link_to_item_in_shop",
"price": 487.00,
"available": true,
"region": "Ukraine, Russia + CIS",
"activation": "Uplay",
"platform": "windows",
"version": "key",
"steam_app_id": "368500"
},
{
"title": "Assassin's Creed: Unity",
"url": "link_to_item_in_shop",
"price": 453.00,
"available": true,
"region": "Region Free",
"activation": "Uplay",
"platform": "windows",
"version": "key",
"steam_app_id": "289650"
},
{
"title": "Assetto Corsa - Ultimate Edition",
"url": "link_to_item_in_shop",
"price": 681.00,
"available": false,
"region": "Russia + CIS (excluding Azerbaijan and Tajikistan)",
"activation": "Steam",
"platform": "windows",
"version": "key",
"steam_app_id": "244210",
"steam_bundle_id": "6998"
},
...
]
...
По запросу мы предоставляем магазинам модераторские аккаунты, используя которые они могут сами добавлять новые предложения с их магазинов (следуя правилам нашего каталога). А также форсировать обновление цен на особенно важные товары, не дожидаясь планового обновления (происходит несколько раз в сутки).