Приложения
Отзывы о приложении
Получите постраничный список пользовательских отзывов для конкретного приложения Steam.
Эндпоинт
Этот эндпоинт возвращает постраничный список пользовательских отзывов для конкретного приложения Steam. Каждая запись содержит текст отзыва, Steam ID автора и его игровое время на момент написания отзыва, счётчики голосов и временные метки.
GET /v2/steam/apps/{appId}/reviews
Обязательные параметры
appId
number
ID приложения Steam.
Параметры запроса
cursor
string
Курсор пагинации. Передайте значение
cursor из предыдущего ответа, чтобы получить следующую страницу.Аутентификация
Укажите ваш API-ключ в заголовке запроса x-api-key.
x-api-key: YourSecretAPIKey
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
results | array | Массив объектов отзывов. |
cursor | string | Курсор для следующей страницы. |
hasMore | boolean | Есть ли ещё результаты. Когда false, вы достигли последней страницы. |
Объект отзыва
| Поле | Тип | Описание |
|---|---|---|
_id | string | ID документа. |
recommendationId | string | Идентификатор отзыва от Steam. |
appId | number | ID приложения Steam, к которому относится отзыв. |
author | object | Информация об авторе. См. поля ниже. |
commentCount | number | Количество комментариев к отзыву. |
language | string | Язык отзыва (например, english, french, german). |
receivedForFree | boolean | Получил ли автор продукт бесплатно. |
review | string | Текст отзыва. |
steamPurchase | boolean | Купил ли автор продукт в Steam. |
timestampCreated | number | Unix-метка времени (в секундах) первой публикации отзыва. |
timestampUpdated | number | Unix-метка времени (в секундах) последнего редактирования отзыва. |
votedUp | boolean | true для положительного (рекомендуемого) отзыва, false для отрицательного. |
votesFunny | number | Количество голосов "смешно" у отзыва. |
votesUp | number | Количество голосов "полезно" у отзыва. |
weightedVoteScore | string | Взвешенная оценка полезности Steam (десятичное число в виде строки, 0–1). |
writtenDuringEarlyAccess | boolean | Был ли отзыв написан во время Early Access. |
Объект автора
| Поле | Тип | Описание |
|---|---|---|
steamId | string | 64-битный Steam ID рецензента. |
playtimeAtReview | number | Количество минут, которые автор сыграл к моменту написания отзыва. |
Пример ответа
response.json
{
"success": true,
"results": [
{
"_id": "69e800477ab054081ee245cd",
"recommendationId": "223802362",
"appId": 2393730,
"author": {
"steamId": "76561198808328024",
"playtimeAtReview": 163
},
"commentCount": 0,
"language": "english",
"receivedForFree": false,
"review": "Great game! Had a lot of fun. It's obviously not a full flight sim, but more of a take off and land sim with management element.",
"steamPurchase": true,
"timestampCreated": 1776804577,
"timestampUpdated": 1776804734,
"votedUp": true,
"votesFunny": 0,
"votesUp": 1,
"weightedVoteScore": "0.529703021049499512",
"writtenDuringEarlyAccess": false
}
],
"cursor": "eyJ2IjoxNzc2NzY4NDg3LCJpZCI6IjY5ZTgwMDQ3N2FiMDU0MDgxZWUyNDVmYSJ9",
"hasMore": true
}
Используйте пагинацию на основе курсора, чтобы получить полную историю отзывов. Когда
hasMore равно false, вы достигли последней страницы.