get_steam_review
Read public Steam reviews by app ID with filters for helpfulness, recency, language, sentiment, purchase type, and optional metadata to analyze player feedback.
Instructions
Reads a page of public Steam reviews directly from Steam. Defaults to helpful ranking, every language, all purchase sources and both sentiments, including off-topic activity. Use recent for new feedback, updated for modifications, and a background corpus for large analyses. fetch_all automatically uses recent for helpful requests. Optional review_details contains timestamps, playtime, numeric helpfulness and refunded metadata; refunds are not filtered. All review fetches share request spacing and 429 cooldown. Anonymous responses may be cached by Steam for up to 10 minutes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appid | Yes | Steam application ID as a numeric string | |
| cursor | No | Cursor for paging. Pass "*" for the first page, then pass the returned next cursor for the next request. | * |
| filter | No | helpful: Steam helpfulness ranking, with its default initial 30-day lookback and quality ranking; recent: newest creation time; updated: latest modification time. Default helpful. Full traversal automatically uses recent for helpful requests. | helpful |
| fetch_all | No | When true, follow cursors through the complete matching set, subject to max_reviews. Helpful requests automatically use recent for exhaustive traversal. Prefer a background corpus for large sets. | |
| languages | No | Review language list, e.g. ['english', 'schinese']. Default ['all']; including 'all' retrieves every language. | |
| max_reviews | No | Optional cap when fetch_all is true. Useful to avoid pulling very large review sets into the model context. | |
| review_type | No | all: all reviews, positive: only positive reviews, negative: only negative reviews | all |
| num_per_page | No | Number of reviews per page. Steam allows up to 100. | |
| purchase_type | No | all: all reviews, non_steam_purchase: users who did not pay on Steam, steam: paid on Steam | all |
| include_review_metadata | No | When true, return review_details in addition to the cleaned review text. review_details includes per-review metadata such as timestamp_created, timestamp_updated, timestamp_dev_responded, and author playtime fields like playtime_at_review and last_played. | |
| filter_offtopic_activity | No | false includes off-topic/review-bomb activity (default); true excludes it. |