Skip to content
Revadike edited this page Dec 31, 2023 · 7 revisions

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 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 reviews
purchase_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)

Response

200 OK

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

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": "*"
}
Clone this wiki locally