-
Notifications
You must be signed in to change notification settings - Fork 23
Get App Reviews
Revadike edited this page Dec 31, 2023
·
7 revisions
No known rate limit
Authenticated: No
Method:
GET
Host:
store.steampowered.com
Path:
/appreviews/:appid
Query Parameters:
Name Type Required Description cursor
string TODO
reviews 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. json
string TODO
TODO
day_range
string TODO
range from now to n days ago to look for helpful reviews. Only applicable for the “all” filter. Maximum value is 365. start_date
string TODO
TODO
end_date
string TODO
TODO
date_range_type
string TODO
TODO
filter
string TODO
recent – sorted by creation time
updated – sorted by last updated time
all – (default) sorted by helpfulness, with sliding windows based on day_range parameter, will always find results to return.
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 TODO
see https://partner.steamgames.com/documentation/languages (and use the API language code list) or pass “all” for all reviews l
string TODO
Language review_type
string TODO
all – all reviews (default)
positive – only positive reviews
negative – only negative reviewspurchase_type
string TODO
all – 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)playtime_filter_min
string TODO
TODO
playtime_filter_max
string TODO
TODO
filter_offtopic_activity
string TODO
by default, off-topic reviews (aka "Review Bombs") are filtered out and are not returned in this API. Pass 0 to include them. summary_num_positive_reviews
string TODO
TODO
summary_num_reviews
string TODO
TODO
num_per_page
string TODO
by default, up to 20 reviews will be returned. More reviews can be returned based on this parameter (with a maximum of 100 reviews)
Name Type Description success
number TODO
query_summary
object TODO
query_summary.num_reviews
number TODO
query_summary.review_score
number TODO
query_summary.review_score_desc
string TODO
query_summary.total_positive
number TODO
query_summary.total_negative
number TODO
query_summary.total_reviews
number TODO
reviews[]
array TODO
reviews[].recommendationid
string TODO
reviews[].author
object TODO
reviews[].author.steamid
string TODO
reviews[].author.num_games_owned
number TODO
reviews[].author.num_reviews
number TODO
reviews[].author.playtime_forever
number TODO
reviews[].author.playtime_last_two_weeks
number TODO
reviews[].author.playtime_at_review
number TODO
reviews[].author.last_played
number TODO
reviews[].language
string TODO
reviews[].review
string TODO
reviews[].timestamp_created
number TODO
reviews[].timestamp_updated
number TODO
reviews[].voted_up
boolean TODO
reviews[].votes_up
number TODO
reviews[].votes_funny
number TODO
reviews[].weighted_vote_score
string TODO
reviews[].comment_count
number TODO
reviews[].steam_purchase
boolean TODO
reviews[].received_for_free
boolean TODO
reviews[].written_during_early_access
boolean TODO
cursor
string TODO
GET https://store.steampowered.com/appreviews/440?cursor=*&json=1&day_range=30&start_date=-1&end_date=-1&date_range_type=all&filter=summary&language=english%2Cdutch&l=english&review_type=all&purchase_type=all&playtime_filter_min=0&playtime_filter_max=0&filter_offtopic_activity=0&summary_num_positive_reviews=25938&summary_num_reviews=28651
{
"success": 1,
"query_summary": {
"num_reviews": 10,
"review_score": 8,
"review_score_desc": "Very Positive",
"total_positive": 447434,
"total_negative": 28582,
"total_reviews": 476016
},
"reviews": [
{
"recommendationid": "96533723",
"author": {
"steamid": "76561198418784448",
"num_games_owned": 54,
"num_reviews": 24,
"playtime_forever": 37453,
"playtime_last_two_weeks": 839,
"playtime_at_review": 34531,
"last_played": 1630011494
},
"language": "english",
"review": " jungle what now? \"the crate depression\"? bot crisis? no updates in years?\n\nwow dude you must've hit your head hard; now come on! love and war just dropped and we're all having a conga party!",
"timestamp_created": 1627499960,
"timestamp_updated": 1627499960,
"voted_up": true,
"votes_up": 533,
"votes_funny": 167,
"weighted_vote_score": "0.963205277919769287",
"comment_count": 18,
"steam_purchase": true,
"received_for_free": false,
"written_during_early_access": false
},
{
"recommendationid": "97092605",
"author": {
"steamid": "76561198311836101",
"num_games_owned": 254,
"num_reviews": 99,
"playtime_forever": 7344,
"playtime_last_two_weeks": 0,
"playtime_at_review": 7344,
"last_played": 1598050007
},
"language": "english",
"review": "Bot kicking simulator",
"timestamp_created": 1628321114,
"timestamp_updated": 1628321114,
"voted_up": true,
"votes_up": 207,
"votes_funny": 87,
"weighted_vote_score": "0.901217639446258545",
"comment_count": 23,
"steam_purchase": false,
"received_for_free": false,
"written_during_early_access": false
},
{
"recommendationid": "96608212",
"author": {
"steamid": "76561198253891895",
"num_games_owned": 28,
"num_reviews": 14,
"playtime_forever": 45702,
"playtime_last_two_weeks": 3859,
"playtime_at_review": 27411,
"last_played": 1629145638
},
"language": "english",
"review": "I ate my wife and kids",
"timestamp_created": 1627612493,
"timestamp_updated": 1627612493,
"voted_up": true,
"votes_up": 322,
"votes_funny": 174,
"weighted_vote_score": "0.898604333400726318",
"comment_count": 16,
"steam_purchase": false,
"received_for_free": false,
"written_during_early_access": false
},
{
"recommendationid": "97149698",
"author": {
"steamid": "76561198092419346",
"num_games_owned": 17,
"num_reviews": 1,
"playtime_forever": 115062,
"playtime_last_two_weeks": 130,
"playtime_at_review": 114720,
"last_played": 1630105255
},
"language": "english",
"review": "At the time of this review, I have played this game for 1912 hours which is the same year the Titanic sunk. Unlike that ship, this game does not sink.",
"timestamp_created": 1628397705,
"timestamp_updated": 1628397705,
"voted_up": true,
"votes_up": 144,
"votes_funny": 47,
"weighted_vote_score": "0.89207226037979126",
"comment_count": 4,
"steam_purchase": false,
"received_for_free": false,
"written_during_early_access": false
},
{
"recommendationid": "96550504",
"author": {
"steamid": "76561198798223613",
"num_games_owned": 102,
"num_reviews": 4,
"playtime_forever": 199146,
"playtime_last_two_weeks": 16374,
"playtime_at_review": 166930,
"last_played": 1630104352
},
"language": "english",
"review": "play this game if you hate the sun",
"timestamp_created": 1627525783,
"timestamp_updated": 1627525783,
"voted_up": true,
"votes_up": 219,
"votes_funny": 70,
"weighted_vote_score": "0.880293130874633789",
"comment_count": 0,
"steam_purchase": false,
"received_for_free": false,
"written_during_early_access": false
},
{
"recommendationid": "96920419",
"author": {
"steamid": "76561198171058391",
"num_games_owned": 35,
"num_reviews": 5,
"playtime_forever": 393446,
"playtime_last_two_weeks": 2351,
"playtime_at_review": 388860,
"last_played": 1630105988
},
"language": "english",
"review": "it's alright",
"timestamp_created": 1628070631,
"timestamp_updated": 1628070631,
"voted_up": true,
"votes_up": 155,
"votes_funny": 124,
"weighted_vote_score": "0.840275883674621582",
"comment_count": 0,
"steam_purchase": false,
"received_for_free": false,
"written_during_early_access": false
},
{
"recommendationid": "97857861",
"author": {
"steamid": "76561198327531255",
"num_games_owned": 25,
"num_reviews": 17,
"playtime_forever": 17793,
"playtime_last_two_weeks": 13327,
"playtime_at_review": 12054,
"last_played": 1630104942
},
"language": "english",
"review": "better than fortnite",
"timestamp_created": 1629377028,
"timestamp_updated": 1629377028,
"voted_up": true,
"votes_up": 112,
"votes_funny": 19,
"weighted_vote_score": "0.824779152870178223",
"comment_count": 20,
"steam_purchase": false,
"received_for_free": false,
"written_during_early_access": false
},
{
"recommendationid": "97745728",
"author": {
"steamid": "76561198127427247",
"num_games_owned": 28,
"num_reviews": 26,
"playtime_forever": 23761,
"playtime_last_two_weeks": 19280,
"playtime_at_review": 9439,
"last_played": 1630104048
},
"language": "english",
"review": "Hats",
"timestamp_created": 1629214569,
"timestamp_updated": 1629214569,
"voted_up": true,
"votes_up": 67,
"votes_funny": 12,
"weighted_vote_score": "0.727068543434143066",
"comment_count": 7,
"steam_purchase": false,
"received_for_free": false,
"written_during_early_access": false
},
{
"recommendationid": "97025337",
"author": {
"steamid": "76561198010207684",
"num_games_owned": 51,
"num_reviews": 1,
"playtime_forever": 438132,
"playtime_last_two_weeks": 2163,
"playtime_at_review": 435839,
"last_played": 1629975129
},
"language": "english",
"review": "Cannot recommend a multiplayer game with no active administrators. Known hacker clans advertise cheats in more than half of all official matchmaker servers and flaunt their racism and disregard for other players. Riddled with vulnerabilities, robots roam from server attempting to kick all other players who don't pay a ransom. In other cases, they purposefully crash both the server and the client with memory leaks.\n\nThe game is opaque and difficult to learn under normal circumstances, made worse by obvious robot players and dishonest humans who flip their cheats on and off in an effort to hide their doping.",
"timestamp_created": 1628224493,
"timestamp_updated": 1628224493,
"voted_up": false,
"votes_up": 208,
"votes_funny": 33,
"weighted_vote_score": "0.706422686576843262",
"comment_count": 0,
"steam_purchase": false,
"received_for_free": false,
"written_during_early_access": false
},
{
"recommendationid": "97395186",
"author": {
"steamid": "76561198260351049",
"num_games_owned": 286,
"num_reviews": 10,
"playtime_forever": 96203,
"playtime_last_two_weeks": 19375,
"playtime_at_review": 74364,
"last_played": 1630105250
},
"language": "english",
"review": "It really is an experience with diverse gameplay and a great community. If you haven't tried it, why not? It's free.\n\nRewards : \nA ton of content both official and fan made\nNice hats\nBalanced and well thought out gameplay rarely found elsewhere\n\nRisks : \nNone it's free",
"timestamp_created": 1628741157,
"timestamp_updated": 1628746122,
"voted_up": true,
"votes_up": 15,
"votes_funny": 2,
"weighted_vote_score": "0.668094217777252197",
"comment_count": 6,
"steam_purchase": false,
"received_for_free": false,
"written_during_early_access": false
}
],
"cursor": "*"
}