Приложения

Детали приложения

Получи подробную информацию о конкретном Steam-приложении, включая описания, изображения, цены и метаданные.

Эндпоинт

Этот endpoint возвращает подробную информацию о конкретном Steam-приложении, включая описания, изображения, цены, системные требования и другие метаданные.

GET   /v2/steam/apps/{appId}

Обязательные параметры

appId
number
Steam application ID.

Аутентификация

Включи свой API-ключ в request header x-api-key.

x-api-key: YourSecretAPIKey

Поля ответа

ПолеТипОписание
resultobject|nullОбъект деталей приложения или null, если не найдено

Объект деталей приложения

ПолеТипОписание
_idstringID документа
appIdnumberSteam application ID
steamAppIdstring|nullСсылка на документ SteamApp
namestring|nullНазвание приложения
typestring|nullТип приложения (например, "game", "dlc")
requiredAgenumberМинимальный требуемый возраст (0, если нет)
isFreebooleanЯвляется ли приложение бесплатным
shortDescriptionstring|nullКраткое описание
detailedDescriptionstring|nullПолное HTML-описание
aboutTheGamestring|nullHTML-контент раздела «Об игре»
developersstringСписок имён разработчиков
publishersstringСписок имён издателей
headerImagestring|nullURL заголовочного изображения
capsuleImagestring|nullURL капсульного изображения
capsuleImageV5string|nullURL капсульного изображения v5
backgroundstring|nullURL фонового изображения
backgroundRawstring|nullURL raw-фонового изображения
screenshotsarrayМассив объектов скриншотов
moviesarrayМассив объектов видео/трейлеров
categoriesarrayМассив объектов категорий
genresarrayМассив объектов жанров
platformsobjectДоступность на платформах
metacriticobjectДанные оценки Metacritic
recommendationsobjectКоличество рекомендаций
achievementsobjectДанные о достижениях
releaseDateobjectИнформация о дате выхода
supportInfoobjectКонтактная информация поддержки
websitestring|nullURL официального сайта
legalNoticestring|nullТекст правового уведомления
reviewsstring|nullЦитаты из обзоров
pcRequirementsobjectСистемные требования для PC
macRequirementsobjectСистемные требования для Mac
linuxRequirementsobjectСистемные требования для Linux
priceOverviewobjectТекущая информация о цене
packagesnumberДоступные ID пакетов
packageGroupsarrayДетали групп пакетов
dlcnumberID связанных DLC-приложений
contentDescriptorsobjectИнформация о content descriptors
controllerSupportstring|nullУровень поддержки контроллера
supportedLanguagesstring|nullHTML-строка поддерживаемых языков
ratingsobject|nullРегиональные возрастные рейтинги

Вложенные объекты

screenshots

ПолеТипОписание
idnumberID скриншота
pathThumbnailstringURL миниатюры
pathFullstringURL полного разрешения

movies

ПолеТипОписание
idnumberID видео
namestringНазвание видео/трейлера
thumbnailstringURL миниатюры
dashAv1stringURL DASH AV1-стрима
dashH264stringURL DASH H.264-стрима
hlsH264stringURL HLS H.264-стрима
highlightbooleanЯвляется ли этот трейлер выделенным

categories / genres

ПолеТипОписание
idnumber/stringID категории или жанра
descriptionstringНазвание категории или жанра

platforms

ПолеТипОписание
windowsbooleanДоступно на Windows
macbooleanДоступно на Mac
linuxbooleanДоступно на Linux

metacritic

ПолеТипОписание
scorenumber|nullОценка Metacritic
urlstring|nullURL страницы Metacritic

releaseDate

ПолеТипОписание
comingSoonbooleanНе вышла ли игра ещё
datestring|nullСтрока даты выхода

priceOverview

ПолеТипОписание
currencystring|nullКод валюты (например, "USD")
initialnumber|nullНачальная цена в центах
finalnumber|nullИтоговая цена в центах (после скидки)
discountPercentnumberПроцент скидки (0, если нет)
initialFormattedstring|nullФорматированная начальная цена
finalFormattedstring|nullФорматированная итоговая цена

pcRequirements / macRequirements / linuxRequirements

ПолеТипОписание
minimumstring|nullHTML минимальных требований
recommendedstring|nullHTML рекомендуемых требований

Пример ответа

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"
      }
    }
  }
}