Steam hub

Steam Review Summary API

The totals behind the review badge: how many reviews, how many recommend the app, and the score.

GET /v1/steam/apps/{appId}/reviews/summary

1 credit Failed requests are free A not-found answer is still charged

About this endpoint

GET /v1/steam/apps/{appId}/reviews/summary returns data.summary with totalReviews, positive, negative, score, scoreLabel and percentPositive. language can be all (the default) or any supported language name or short code, and data.language echoes the result. purchase selects the purchase types: all (the default) counts every review, steam counts Steam purchases only, which is the figure on an app record, and other counts activated keys and free copies. data.purchase echoes the choice.

score runs from 0 to 9, where 9 is overwhelmingly positive, and scoreLabel is Steam's own wording. percentPositive is null when the app has no reviews. This route returns the totals only, so use the reviews route when you also need the review text.

Steam Review Summary API FAQ

How do I get a Steam app's review totals?

Call GET /v1/steam/apps/{appId}/reviews/summary. Read data.summary.totalReviews, positive, negative, score, scoreLabel and percentPositive. Pass language to limit the totals to one language and purchase=all or purchase=steam to choose the purchase types. purchase=all is the default and counts every review.

What do score and scoreLabel mean?

score is Steam's 0 to 9 review score for the selected reviews, and scoreLabel is its wording, such as Very Positive or Overwhelmingly Positive. Both are null when there are no reviews to score.

Does it return individual reviews?

No. It returns totals only. Use GET /v1/steam/apps/{appId}/reviews for pages of reviews with text and author details. The two routes share the same review summary shape.

What happens for an app that does not exist?

data.lookupStatus is not_found and data.summary is null. HTTP 200 still means the request finished. Branch on lookupStatus before reading the totals.

How many credits does a review summary cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.