Приложения
Детали приложения
Получи подробную информацию о конкретном Steam-приложении, включая описания, изображения, цены и метаданные.
Эндпоинт
Этот endpoint возвращает подробную информацию о конкретном Steam-приложении, включая описания, изображения, цены, системные требования и другие метаданные.
GET /v2/steam/apps/{appId}
Обязательные параметры
appId
number
Steam application ID.
Аутентификация
Включи свой API-ключ в request header x-api-key.
x-api-key: YourSecretAPIKey
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
result | object|null | Объект деталей приложения или null, если не найдено |
Объект деталей приложения
| Поле | Тип | Описание |
|---|---|---|
_id | string | ID документа |
appId | number | Steam application ID |
steamAppId | string|null | Ссылка на документ SteamApp |
name | string|null | Название приложения |
type | string|null | Тип приложения (например, "game", "dlc") |
requiredAge | number | Минимальный требуемый возраст (0, если нет) |
isFree | boolean | Является ли приложение бесплатным |
shortDescription | string|null | Краткое описание |
detailedDescription | string|null | Полное HTML-описание |
aboutTheGame | string|null | HTML-контент раздела «Об игре» |
developers | string | Список имён разработчиков |
publishers | string | Список имён издателей |
headerImage | string|null | URL заголовочного изображения |
capsuleImage | string|null | URL капсульного изображения |
capsuleImageV5 | string|null | URL капсульного изображения v5 |
background | string|null | URL фонового изображения |
backgroundRaw | string|null | URL raw-фонового изображения |
screenshots | array | Массив объектов скриншотов |
movies | array | Массив объектов видео/трейлеров |
categories | array | Массив объектов категорий |
genres | array | Массив объектов жанров |
platforms | object | Доступность на платформах |
metacritic | object | Данные оценки Metacritic |
recommendations | object | Количество рекомендаций |
achievements | object | Данные о достижениях |
releaseDate | object | Информация о дате выхода |
supportInfo | object | Контактная информация поддержки |
website | string|null | URL официального сайта |
legalNotice | string|null | Текст правового уведомления |
reviews | string|null | Цитаты из обзоров |
pcRequirements | object | Системные требования для PC |
macRequirements | object | Системные требования для Mac |
linuxRequirements | object | Системные требования для Linux |
priceOverview | object | Текущая информация о цене |
packages | number | Доступные ID пакетов |
packageGroups | array | Детали групп пакетов |
dlc | number | ID связанных DLC-приложений |
contentDescriptors | object | Информация о content descriptors |
controllerSupport | string|null | Уровень поддержки контроллера |
supportedLanguages | string|null | HTML-строка поддерживаемых языков |
ratings | object|null | Региональные возрастные рейтинги |
Вложенные объекты
screenshots
| Поле | Тип | Описание |
|---|---|---|
id | number | ID скриншота |
pathThumbnail | string | URL миниатюры |
pathFull | string | URL полного разрешения |
movies
| Поле | Тип | Описание |
|---|---|---|
id | number | ID видео |
name | string | Название видео/трейлера |
thumbnail | string | URL миниатюры |
dashAv1 | string | URL DASH AV1-стрима |
dashH264 | string | URL DASH H.264-стрима |
hlsH264 | string | URL HLS H.264-стрима |
highlight | boolean | Является ли этот трейлер выделенным |
categories / genres
| Поле | Тип | Описание |
|---|---|---|
id | number/string | ID категории или жанра |
description | string | Название категории или жанра |
platforms
| Поле | Тип | Описание |
|---|---|---|
windows | boolean | Доступно на Windows |
mac | boolean | Доступно на Mac |
linux | boolean | Доступно на Linux |
metacritic
| Поле | Тип | Описание |
|---|---|---|
score | number|null | Оценка Metacritic |
url | string|null | URL страницы Metacritic |
releaseDate
| Поле | Тип | Описание |
|---|---|---|
comingSoon | boolean | Не вышла ли игра ещё |
date | string|null | Строка даты выхода |
priceOverview
| Поле | Тип | Описание |
|---|---|---|
currency | string|null | Код валюты (например, "USD") |
initial | number|null | Начальная цена в центах |
final | number|null | Итоговая цена в центах (после скидки) |
discountPercent | number | Процент скидки (0, если нет) |
initialFormatted | string|null | Форматированная начальная цена |
finalFormatted | string|null | Форматированная итоговая цена |
pcRequirements / macRequirements / linuxRequirements
| Поле | Тип | Описание |
|---|---|---|
minimum | string|null | HTML минимальных требований |
recommended | string|null | HTML рекомендуемых требований |
Пример ответа
response.json
{
"success": true,
"response": {
"result": {
"_id": "6789abcdef012345",
"appId": 730,
"name": "Counter-Strike 2",
"type": "game",
"requiredAge": 0,
"isFree": true,
"shortDescription": "Counter-Strike 2 expands upon the team-based action gameplay...",
"developers": ["Valve"],
"publishers": ["Valve"],
"headerImage": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/730/header.jpg",
"platforms": {
"windows": true,
"mac": false,
"linux": true
},
"genres": [
{ "id": "1", "description": "Action" },
{ "id": "37", "description": "Free to Play" }
],
"releaseDate": {
"comingSoon": false,
"date": "21 Aug, 2012"
},
"priceOverview": {
"currency": "USD",
"initial": 0,
"final": 0,
"discountPercent": 0,
"initialFormatted": "",
"finalFormatted": "Free to Play"
}
}
}
}