---
title: "List reviews for a Steam app"
method: GET
path: "/steam/reviews"
tags: ["Steam"]
---

# List reviews for a Steam app

`GET /steam/reviews`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/steam/reviews`
- Auth: API key in header `x-api-key`

Returns a page of user reviews for an app with cursor pagination and an aggregate query_summary (score, positive/negative totals). Aggregate totals populate only on the first page (cursor=*). Pass the returned cursor back to page.

## Query parameters

- `appid` string, required
- `filter` 'recent' | 'updated' | 'all'
- `language` string
- `review_type` 'all' | 'positive' | 'negative'
- `purchase_type` 'all' | 'steam' | 'non_steam_purchase'
- `day_range` integer
- `num_per_page` integer
- `cursor` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SteamReviewsResponseDoc
  - `code` integer
  - `data` SteamReviewsResponse
    - `appid` string: Steam app id the reviews belong to.
    - `count` integer: Number of reviews returned.
    - `cursor` string: Cursor to pass back to fetch the next page of reviews.
    - `query_summary` SteamReviewSummary
      - `num_reviews` integer: Number of reviews returned in this response.
      - `review_score` integer: Numeric review score Steam gives the app. Set on the first page only.
      - `review_score_desc` string: Review rating label, such as `Very Positive`. Set on the first page only.
      - `total_negative` integer: Total number of negative reviews. Set on the first page only.
      - `total_positive` integer: Total number of positive reviews. Set on the first page only.
      - `total_reviews` integer: Total number of reviews. Set on the first page only.
    - `reviews` SteamReview[]: Reviews on this page.
      - `author` SteamReviewAuthor
        - `last_played` integer: Time the author last played the game.
        - `num_games_owned` integer: Number of games the author owns on Steam.
        - `num_reviews` integer: Number of reviews the author has written on Steam.
        - `playtime_at_review` integer: Author's playtime in the game when the review was written, in minutes.
        - `playtime_forever` integer: Author's total playtime in the game, in minutes.
        - `playtime_last_two_weeks` integer: Author's playtime in the game over the last two weeks, in minutes.
        - `steamid` string: Steam id of the review author.
      - `comment_count` integer: Number of comments on the review.
      - `language` string: Language the review is written in, as a Steam language name such as `english`.
      - `received_for_free` boolean: Whether the author received the game for free.
      - `recommendation_id` string: Steam id of the review.
      - `review` string: Full text of the review.
      - `steam_purchase` boolean: Whether the author bought the game on Steam.
      - `timestamp_created` integer: Time the review was posted, in Unix seconds.
      - `timestamp_updated` integer: Time the review was last edited, in Unix seconds.
      - `voted_up` boolean: Whether the review recommends the game.
      - `votes_funny` integer: Number of votes marking the review as funny.
      - `votes_up` integer: Number of votes marking the review as helpful.
      - `weighted_vote_score` string: Helpfulness score Steam gives the review, returned as a string such as `0.5`.
      - `written_during_early_access` boolean: Whether the review was written while the game was in Early Access.
    - `source_url` string: URL the data was read from.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)