Steamworks 문서
사용자 평가 - 목록 받기
Steam에서 특정 애플리케이션의 평가를 모두 받아 보고 싶다면, 아래의 매개변수와 함께 다음 메소드를 사용하세요.

매개변수:

GET store.steampowered.com/appreviews/<appid>?json=1
이름종류필수설명
filterstringrecent - 생성 시간으로 정렬
updated - 마지막 업데이트 시간으로 정렬
all - (기본값) 유용함에 따라 정렬. day_range 매개변수에 따라 슬라이드식 창으로 표시되며, 항상 결과값을 반환합니다.

If paging through the reviews with cursor then choose either the recent option or the updated option to eventually receive an empty response list.
language string모든 평가를 표시하려면 https://partner.steamgames.com/documentation/languages서 API 언어 코드 목록을 사용하거나, 'all'을 전달하세요.
day_range string오늘부터 n일 전까지의 유용한 평가를 찾습니다. '모두' 필터에서만 적용할 수 있습니다. Maximum value is 365.
cursorstringreviews are returned in batches of 20, so pass "*" for the first set, then the value of "cursor" that was returned in the response for the next set, etc. Note that cursor values may contain characters that need to be URLEncoded for use in the querystring.
review_typestringall - 모든 평가(기본값)
positive - 긍정적인 평가만
negative - 부정적인 평가만
purchase_typestringall – all reviews
non_steam_purchase – reviews written by users who did not pay for the product on Steam
steam – reviews written by users who paid for the product on Steam (default)
num_per_pagestring기본적으로 최대 20개의 평가가 반환됩니다. 이 매개변수에 따라 더 많은 평가(최대 100개)가 반환될 수도 있습니다.
filter_offtopic_activitynumberby default, off-topic reviews (aka "Review Bombs") are filtered out and are not returned in this API. Pass 0 to include them. See here.

반환값

a JSON formatted list of reviews matching the parameters, with info fields. Strings in JSON may contain escape sequences and data in the response may need to be unescaped before use.

응답:
  • success - 1 if the query was successful
  • query_summary - Returned in the first request
    • num_reviews - The number of reviews returned in this response
    • review_score - The review score
    • review_score_desc - The description of the review score
    • total_positive - Total number of positive reviews
    • total_negative - Total number of negative reviews
    • total_reviews - Total number of reviews matching the query parameters
  • cursor - The value to pass into the next request as the cursor to retrieve the next batch of reviews
  • reviews
    • recommendationid - The unique id of the recommendation
    • author
      • steamid - the user’s SteamID
      • num_games_owned - number of games owned by the user
      • num_reviews - number of reviews written by the user
      • playtime_forever - lifetime playtime tracked in this app
      • playtime_last_two_weeks - playtime tracked in the past two weeks for this app
      • playtime_at_review - playtime when the review was written
      • last_played - time for when the user last played
    • language - language the user indicated when authoring the review
    • review - text of written review
    • timestamp_created - date the review was created (unix timestamp)
    • timestamp_updated - date the review was last updated (unix timestamp)
    • voted_up - true means it was a positive recommendation
    • votes_up - the number of users that found this review helpful
    • votes_funny - the number of users that found this review funny
    • weighted_vote_score - helpfulness score
    • comment_count - number of comments posted on this review
    • steam_purchase - true if the user purchased the game on Steam
    • received_for_free - true if the user checked a box saying they got the app for free
    • written_during_early_access - true if the user posted this review while the game was in Early Access
    • developer_response - text of the developer response, if any
    • timestamp_dev_responded - Unix timestamp of when the developer responded, if applicable