Get App Reviews

GET /appreviews/:appid

Rate limits

No known rate limit

Request

Authenticated: No

Method: GET

Host: store.steampowered.com

Path: /appreviews/:appid

Query Parameters:

Name Type Required Description

cursor string No 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 No 1 – true, returns the response in the JSON format
0 – false, returns the response as JSON with HTML fields.

day_range string No 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 No unix timestamp marking the earliest time to include or exclude reviews. See date_range_type.

end_date string No unix timestamp marking the latest time to include or exclude reviews. See date_range_type.

date_range_type string No include – include only reviews between start_date and end_date
exclude – exclude all reviews between start_date and end_date
all – (default) include all reviews irrespective of time. Ignores start_date and end_date.

filter string No recent – sorted by creation time
updated – sorted by last updated time
all – sorted by helpfulness, with sliding windows based on day_range parameter, will always find results to return.
summary – (default) sorted by helpfulness, strictly returns 10 reviews without paging (ignores num_per_page), represents the summary score by including reviews based on the proportion of positive to negative votes (see the corresponding blog article)

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 No Comma-seperated list of review languages. Reviews written in a different language will be filted out. See https://partner.steamgames.com/documentation/languages (and use the API language code list) or pass “all” for all reviews

l string No Language. If specified, it will return language data for the requested language. Does not change the language filter for reviews, but changes the language of language data provided by Steam.

review_type string No all – all reviews (default)
positive – only positive reviews
negative – only negative reviews

purchase_type string No 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 No minimum number of hours of time that reviewers need to have played a game, otherwise they are filtered out and are not returned in this API. Pass 0 to ignore minimum playtime.

playtime_filter_max string No maximum number of hours of time that reviewers need to have played a game, otherwise they are filtered out and are not returned in this API. Pass 0 to ignore maximum playtime.

filter_offtopic_activity string No 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 No TODO

summary_num_reviews string No TODO

num_per_page string No by default, up to 20 reviews will be returned. More reviews can be returned based on this parameter (with a maximum of 100 reviews)

Response

200 OK

Name Type Description

success number Query status code
1 – Successful
2 – Not successful

query_summary object Summary information on all reviews on the given appid

query_summary.num_reviews number Number of reviews returned in the response

query_summary.review_score number Aggregate review score

query_summary.review_score_desc string Aggregate review score description

query_summary.total_positive number Total number of positive reviews

query_summary.total_negative number Total number of negative reviews

query_summary.total_reviews number Total number of all reviews

reviews[] array Data on the review

reviews[].recommendationid string Recommendation ID

reviews[].author object Data on the review author

reviews[].author.steamid string Steam ID64 of the review author

reviews[].author.num_games_owned number Number of owned games of the review author

reviews[].author.num_reviews number Number of published reviews by the review author

reviews[].author.playtime_forever number Total playtime of the review author

reviews[].author.playtime_last_two_weeks number Playtime of the review author in the last two weeks

reviews[].author.playtime_at_review number Playtime of the review author at the time of the review

reviews[].author.last_played number Unix timestamp of the last time the review author has started the reviewed game

reviews[].language string Language of the review

reviews[].review string Review text

reviews[].timestamp_created number Unix timestamp of the review creation

reviews[].timestamp_updated number Unix timestamp of the review update

reviews[].voted_up boolean Whether the review has given the reviewed game an upvote

reviews[].votes_up number Number of upvotes for the review

reviews[].votes_funny number Number of funny votes for the review

reviews[].weighted_vote_score string Helpfulness score as a percentage weight where scores closer to one are deemed more helpful and scores closer to 0 less helpful, see the corresponding blog article

reviews[].comment_count number Number of comments on the review

reviews[].steam_purchase boolean Whether the reviewer bought the game on Steam

reviews[].received_for_free boolean Whether the reviewer received the game for free

reviews[].written_during_early_access boolean Whether the review was written during Early Access

cursor string Identifier of a review page. Pass this to the cursor argument of the query to retrieve the next page. Useful for iterating through reviews if the demanded number of reviews exceeds num_per_page. If filter is "summary", this value is always *.

Example

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Get App Reviews

GET /appreviews/:appid

Rate limits

Request

Response

200 OK

Example

Clone this wiki locally

Name	Type	Required	Description
`cursor`	string	No	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	No	1 – true, returns the response in the JSON format 0 – false, returns the response as JSON with HTML fields.
`day_range`	string	No	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	No	unix timestamp marking the earliest time to include or exclude reviews. See `date_range_type`.
`end_date`	string	No	unix timestamp marking the latest time to include or exclude reviews. See `date_range_type`.
`date_range_type`	string	No	include – include only reviews between `start_date` and `end_date` exclude – exclude all reviews between `start_date` and `end_date` all – (default) include all reviews irrespective of time. Ignores `start_date` and `end_date`.
`filter`	string	No	recent – sorted by creation time updated – sorted by last updated time all – sorted by helpfulness, with sliding windows based on day_range parameter, will always find results to return. summary – (default) sorted by helpfulness, strictly returns 10 reviews without paging (ignores `num_per_page`), represents the summary score by including reviews based on the proportion of positive to negative votes (see the corresponding blog article) 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	No	Comma-seperated list of review languages. Reviews written in a different language will be filted out. See https://partner.steamgames.com/documentation/languages (and use the API language code list) or pass “all” for all reviews
`l`	string	No	Language. If specified, it will return language data for the requested language. Does not change the language filter for reviews, but changes the language of language data provided by Steam.
`review_type`	string	No	all – all reviews (default) positive – only positive reviews negative – only negative reviews
`purchase_type`	string	No	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	No	minimum number of hours of time that reviewers need to have played a game, otherwise they are filtered out and are not returned in this API. Pass 0 to ignore minimum playtime.
`playtime_filter_max`	string	No	maximum number of hours of time that reviewers need to have played a game, otherwise they are filtered out and are not returned in this API. Pass 0 to ignore maximum playtime.
`filter_offtopic_activity`	string	No	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	No	`TODO`
`summary_num_reviews`	string	No	`TODO`
`num_per_page`	string	No	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	Query status code 1 – Successful 2 – Not successful
`query_summary`	object	Summary information on all reviews on the given appid
`query_summary.num_reviews`	number	Number of reviews returned in the response
`query_summary.review_score`	number	Aggregate review score
`query_summary.review_score_desc`	string	Aggregate review score description
`query_summary.total_positive`	number	Total number of positive reviews
`query_summary.total_negative`	number	Total number of negative reviews
`query_summary.total_reviews`	number	Total number of all reviews
`reviews[]`	array	Data on the review
`reviews[].recommendationid`	string	Recommendation ID
`reviews[].author`	object	Data on the review author
`reviews[].author.steamid`	string	Steam ID64 of the review author
`reviews[].author.num_games_owned`	number	Number of owned games of the review author
`reviews[].author.num_reviews`	number	Number of published reviews by the review author
`reviews[].author.playtime_forever`	number	Total playtime of the review author
`reviews[].author.playtime_last_two_weeks`	number	Playtime of the review author in the last two weeks
`reviews[].author.playtime_at_review`	number	Playtime of the review author at the time of the review
`reviews[].author.last_played`	number	Unix timestamp of the last time the review author has started the reviewed game
`reviews[].language`	string	Language of the review
`reviews[].review`	string	Review text
`reviews[].timestamp_created`	number	Unix timestamp of the review creation
`reviews[].timestamp_updated`	number	Unix timestamp of the review update
`reviews[].voted_up`	boolean	Whether the review has given the reviewed game an upvote
`reviews[].votes_up`	number	Number of upvotes for the review
`reviews[].votes_funny`	number	Number of funny votes for the review
`reviews[].weighted_vote_score`	string	Helpfulness score as a percentage weight where scores closer to one are deemed more helpful and scores closer to 0 less helpful, see the corresponding blog article
`reviews[].comment_count`	number	Number of comments on the review
`reviews[].steam_purchase`	boolean	Whether the reviewer bought the game on Steam
`reviews[].received_for_free`	boolean	Whether the reviewer received the game for free
`reviews[].written_during_early_access`	boolean	Whether the review was written during Early Access
`cursor`	string	Identifier of a review page. Pass this to the `cursor` argument of the query to retrieve the next page. Useful for iterating through reviews if the demanded number of reviews exceeds `num_per_page`. If `filter` is "summary", this value is always `*`.