Steam Reviews API Documentation
The Steam Reviews API returns user reviews of a Steam app, with each review's text, recommendation, votes, language, dates, playtime and author, and the app's review summary. You can sort the reviews and filter them by language, recommendation, purchase type, time period, playtime and Steam Deck.
By default, the API returns the most helpful English reviews of the last 365 days, from every purchase type.
Reviews from periods Steam marks as off-topic review activity are left out, as on its store page.
The review summary in product counts the reviews that match the filters. Steam sends it on the first page only, and not with review_type.
To get the next page, pass pagination.next_page_token with the same app_id.
The token carries the filters, sort and page size of the request that returned it, and the reviews are numbered on from the earlier pages.
API Parameters
Search Query
-
- Name
-
app_id - Required
- Required
- Description
-
Parameter defines the Steam app ID to get reviews for. It is the number in the app's store page URL, such as
588650inhttps://store.steampowered.com/app/588650/Dead_Cells/, from 1 to 4294967295.
Review Filters
-
- Name
-
hl - Required
- Optional
- Description
-
Parameter defines the language of the reviews. Supported values are
ar,bg,zh-cn,zh-tw,cs,da,nl,en,fi,fr,de,el,hu,id,it,ja,ko,ms,no,pl,pt,pt-br,ro,ru,es,es-419,sv,th,tr,uk, andvi, orallfor reviews in every language.
-
- Name
-
review_type - Required
- Optional
- Description
-
Parameter filters the reviews by recommendation. Supported values are
positive,negative, andall. Withpositiveornegative, the response has no review summary inproduct.
-
- Name
-
purchase_type - Required
- Optional
- Description
-
Parameter filters the reviews by how the author got the app. Supported values are
steam,non_steam, andall.steamis reviews by people who bought it on Steam, andnon_steamthe rest.
-
- Name
-
time_period_min - Required
- Optional
- Description
-
Parameter defines the first day of the time period the reviews were written in, as
YYYY-MM-DDorMM/DD/YYYY, in UTC, from 1970 to 2099. It can be used alone or withtime_period_max.
-
- Name
-
time_period_max - Required
- Optional
- Description
-
Parameter defines the last day of the time period the reviews were written in, as
YYYY-MM-DDorMM/DD/YYYY, in UTC. It can be used alone or withtime_period_min, and must not be before it.
-
- Name
-
playtime_min - Required
- Optional
- Description
-
Parameter defines the fewest hours the author had played the app when writing the review, a whole number from 1 to 35,791,394.
-
- Name
-
playtime_max - Required
- Optional
- Description
-
Parameter defines the most hours the author had played the app when writing the review, a whole number from 1 to 35,791,394. It must not be below
playtime_min.
-
- Name
-
is_primarily_steam_deck - Required
- Optional
- Description
-
Set this parameter to
trueto return only reviews whose author played the app mostly on Steam Deck.
Sorting
-
- Name
-
sort_by - Required
- Optional
- Description
-
Parameter defines the order of the reviews. Supported values:
most_helpfulDefaultmost_recentrecently_updatedfunniest
most_helpfulranks the reviews written in the lastday_rangedays by how helpful readers found them. With a time period, it ranks the reviews of that period instead. A period that starts more than a year ago and has not ended or ended in the last 180 days is ranked over its last year only, so usemost_recentto get all of it.
-
- Name
-
day_range - Required
- Optional
- Description
-
Parameter defines how many days back
most_helpfullooks for reviews, from 1 to 365. When those days hold no reviews, Steam looks further back, up to all of the app's reviews. It works only withsort_by=most_helpful, and has no effect withtime_period_minortime_period_max.
Pagination
-
- Name
-
num - Required
- Optional
- Description
-
Parameter defines the number of reviews per page, from 1 to 100.
-
- Name
-
next_page_token - Required
- Optional
- Description
-
Parameter defines the next page to get. Use the
pagination.next_page_tokenof the previous response with the sameapp_id. It carries that request's filters, sort and page size, so other parameters can be left out.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
steam_reviews.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
https://www.searchapi.io/api/v1/search?app_id=588650&engine=steam_reviews
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "steam_reviews",
"app_id": "588650"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_B5dc7HuB1ztoQA5RLGSrs3x8",
"status": "Success",
"created_at": "2026-11-18T14:49:24Z",
"request_time_taken": 2.4,
"parsing_time_taken": 0.0,
"total_time_taken": 2.41,
"request_url": "https://store.steampowered.com/app/588650/",
"html_url": "https://www.searchapi.io/api/v1/searches/search_B5dc7HuB1ztoQA5RLGSrs3x8.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_B5dc7HuB1ztoQA5RLGSrs3x8"
},
"search_parameters": {
"engine": "steam_reviews",
"app_id": "588650"
},
"search_information": {
"total_results": 3425
},
"product": {
"app_id": 588650,
"link": "https://store.steampowered.com/app/588650/",
"rating_label": "Overwhelmingly Positive",
"reviews": 52113,
"positive_reviews": 50223,
"negative_reviews": 1890,
"recommended_percentage": 96
},
"reviews": [
{
"position": 1,
"review_id": "237430942",
"link": "https://steamcommunity.com/profiles/76561199150763415/recommended/588650/",
"text": "I am writing on behalf of my deceased friend who spent many hours on this game. i have not played it personally, but he very much enjoyed it while in hospital.\nI recommend it.",
"is_recommended": true,
"language": "en",
"iso_date": "2026-10-11T04:01:02Z",
"iso_last_updated": "2026-10-11T04:01:02Z",
"helpful_votes": 260,
"funny_votes": 3,
"weighted_vote_score": 0.9409636855125427,
"comments": 0,
"awards": [
{
"title": "Beautiful",
"count": 88,
"thumbnail": "https://store.akamai.steamstatic.com/public/images/loyalty/reactions/still/25.png"
},
{
"title": "Wholesome",
"count": 15,
"thumbnail": "https://store.akamai.steamstatic.com/public/images/loyalty/reactions/still/35.png"
},
{
"title": "Helpful",
"count": 12,
"thumbnail": "https://store.akamai.steamstatic.com/public/images/loyalty/reactions/still/26.png"
},
{
"title": "Winner",
"count": 2,
"thumbnail": "https://store.akamai.steamstatic.com/public/images/loyalty/reactions/still/24.png"
},
{
"title": "Pure Gold",
"count": 1,
"thumbnail": "https://store.akamai.steamstatic.com/public/images/loyalty/reactions/still/34.png"
}
],
"is_steam_purchase": true,
"is_received_for_free": false,
"is_written_during_early_access": false,
"is_primarily_steam_deck": false,
"is_refunded": false,
"user": {
"steam_id": "76561199150763415",
"name": "Chirrinchi",
"link": "https://steamcommunity.com/profiles/76561199150763415/",
"thumbnail": "https://avatars.steamstatic.com/76c2c57990ae1af551df7337b66debf3946cccbc_full.jpg",
"games_owned": 183,
"reviews": 15,
"iso_last_played": "2026-11-08T16:13:57Z",
"playtime": {
"total_minutes": 30880,
"last_two_weeks_minutes": 128,
"at_review_minutes": 30752,
"steam_deck_at_review_minutes": 45
}
}
},
{
"position": 6,
"review_id": "235629905",
"link": "https://steamcommunity.com/profiles/76561198980477019/recommended/588650/",
"text": "Derelict Distillery is genuinely among the top 5 worst locations in gaming",
"is_recommended": true,
"language": "en",
"iso_date": "2026-09-19T18:19:44Z",
"iso_last_updated": "2026-09-19T18:19:44Z",
"helpful_votes": 38,
"funny_votes": 15,
"weighted_vote_score": 0.775916576385498,
"comments": 3,
"awards": [
{
"title": "Funny",
"count": 2,
"thumbnail": "https://store.akamai.steamstatic.com/public/images/loyalty/reactions/still/28.png"
},
{
"title": "Perfect",
"count": 1,
"thumbnail": "https://store.akamai.steamstatic.com/public/images/loyalty/reactions/still/31.png"
}
],
"is_steam_purchase": false,
"is_received_for_free": false,
"is_written_during_early_access": false,
"is_primarily_steam_deck": false,
"is_refunded": false,
"user": {
"steam_id": "76561198980477019",
"name": "Emanutz",
"link": "https://steamcommunity.com/id/Emanutz/",
"thumbnail": "https://avatars.steamstatic.com/e1dde7fe207a397634580d4755f7890ccf24ddd7_full.jpg",
"games_owned": 163,
"reviews": 15,
"iso_last_played": "2026-10-29T18:57:32Z",
"playtime": {
"total_minutes": 3338,
"last_two_weeks_minutes": 0,
"at_review_minutes": 2439
}
},
"hardware": {
"os": "Windows 11",
"cpu": "AMD Ryzen 5 4500 6-Core Processor",
"gpu": "AMD Radeon RX 9060 XT",
"ram_mb": 32660,
"vram_mb": 16200
}
},
"..."
],
"pagination": {
"next_page_token": "WzEsIkFvSUZRRld4TVNBQUFBQjN1WWY4Qmc9PSIsIjU4ODY1MCIsIm1vc3RfaGVscGZ1bCIsImVuIixudWxsLG51bGwsbnVsbCxudWxsLCIzNjUiLG51bGwsbnVsbCxudWxsLCIyMCIsIjIwIl0"
}
}
Review Filters and Sorting
https://www.searchapi.io/api/v1/search?app_id=1091500&engine=steam_reviews&playtime_min=10&purchase_type=steam&review_type=negative&sort_by=most_recent
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "steam_reviews",
"app_id": "1091500",
"review_type": "negative",
"purchase_type": "steam",
"playtime_min": "10",
"sort_by": "most_recent"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_TtjI1viHQEQVu93tZwXVVARB",
"status": "Success",
"created_at": "2026-11-18T14:49:31Z",
"request_time_taken": 1.74,
"parsing_time_taken": 0.0,
"total_time_taken": 1.75,
"request_url": "https://store.steampowered.com/app/1091500/",
"html_url": "https://www.searchapi.io/api/v1/searches/search_TtjI1viHQEQVu93tZwXVVARB.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_TtjI1viHQEQVu93tZwXVVARB"
},
"search_parameters": {
"engine": "steam_reviews",
"app_id": "1091500",
"sort_by": "most_recent",
"review_type": "negative",
"purchase_type": "steam",
"playtime_min": "10"
},
"search_information": {
"total_results": 29578
},
"product": {
"app_id": 1091500,
"link": "https://store.steampowered.com/app/1091500/"
},
"reviews": [
{
"position": 1,
"review_id": "240491299",
"link": "https://steamcommunity.com/profiles/76561198999948338/recommended/1091500/",
"text": "o kadar sene oldu oyunda hala bug ve hatalar var, yeni şeyler eklemenize bir lafım yok ama siktiğimin oyununu aldığımda buglu diye 1.5 sürümüne kadar oynamadım yapacağınız düzeltmelerin ta a** koyim, 2.5 güncellemesi geldi oyun hala sıkıntı...",
"is_recommended": false,
"language": "en",
"iso_date": "2026-11-18T09:03:09Z",
"iso_last_updated": "2026-11-18T09:04:28Z",
"helpful_votes": 0,
"funny_votes": 1,
"weighted_vote_score": 0.5,
"comments": 0,
"is_steam_purchase": true,
"is_received_for_free": false,
"is_written_during_early_access": false,
"is_primarily_steam_deck": false,
"is_refunded": false,
"user": {
"steam_id": "76561198999948338",
"name": "Dark knight",
"link": "https://steamcommunity.com/profiles/76561198999948338/",
"thumbnail": "https://avatars.steamstatic.com/19b89c07b7d66c2ab18c9b722bf86c25876e9016_full.jpg",
"games_owned": 152,
"reviews": 5,
"iso_last_played": "2026-11-18T14:46:55Z",
"playtime": {
"total_minutes": 14651,
"last_two_weeks_minutes": 3936,
"at_review_minutes": 14389
}
}
},
{
"position": 3,
"review_id": "240477110",
"link": "https://steamcommunity.com/profiles/76561198152341150/recommended/1091500/",
"text": "I don't recommend it as I KEEP INSTALLING MODS IT'S TOO GOOD IT'S BEEN OVER 500 MODS STOP MAKING MODS I BARELY CAN PLAY IT WITHOUT THINKING \"oh let's add a mod for this\" STOOP",
"is_recommended": false,
"language": "en",
"iso_date": "2026-11-18T02:31:09Z",
"iso_last_updated": "2026-11-18T02:31:09Z",
"helpful_votes": 0,
"funny_votes": 1,
"weighted_vote_score": 0.5,
"comments": 0,
"is_steam_purchase": true,
"is_received_for_free": false,
"is_written_during_early_access": false,
"is_primarily_steam_deck": false,
"is_refunded": false,
"user": {
"steam_id": "76561198152341150",
"name": "hawkeysim",
"link": "https://steamcommunity.com/id/supitshawk/",
"thumbnail": "https://avatars.steamstatic.com/7803be7f565d41f8f9e89ccb3210ebf2d237f8bf_full.jpg",
"games_owned": 197,
"reviews": 10,
"iso_last_played": "2026-11-17T18:42:37Z",
"playtime": {
"total_minutes": 3801,
"last_two_weeks_minutes": 2335,
"at_review_minutes": 3801
}
},
"hardware": {
"os": "Windows 11",
"cpu": "12th Gen Intel(R) Core(TM) i5-12500H",
"gpu": "NVIDIA GeForce RTX 3050 Laptop GPU",
"ram_mb": 15999,
"vram_mb": 3962
}
},
{
"position": 19,
"review_id": "240392802",
"link": "https://steamcommunity.com/profiles/76561198335008960/recommended/1091500/",
"text": "For how long this game has been out, there are still a lot of bugs. Multiple missions that you can not complete, had at least three random crashes over 70 hours of play. Would think CC Projekt Red would put out a better product. If you stil...",
"is_recommended": false,
"language": "en",
"iso_date": "2026-11-17T00:25:15Z",
"iso_last_updated": "2026-11-17T00:25:15Z",
"helpful_votes": 1,
"funny_votes": 0,
"weighted_vote_score": 0.5,
"comments": 1,
"awards": [
{
"title": "Winner",
"count": 1,
"thumbnail": "https://store.akamai.steamstatic.com/public/images/loyalty/reactions/still/24.png"
}
],
"is_steam_purchase": true,
"is_received_for_free": false,
"is_written_during_early_access": false,
"is_primarily_steam_deck": false,
"is_refunded": false,
"user": {
"steam_id": "76561198335008960",
"name": "Shalukero",
"link": "https://steamcommunity.com/profiles/76561198335008960/",
"thumbnail": "https://avatars.steamstatic.com/d84b44e323df52a39d066b5438367e9507a4791d_full.jpg",
"reviews": 1,
"iso_last_played": "2026-11-17T01:35:38Z",
"playtime": {
"total_minutes": 6651,
"last_two_weeks_minutes": 3763,
"at_review_minutes": 6577
}
}
},
"..."
],
"pagination": {
"next_page_token": "WzEsIkFvSndqYytiODZFRGY2YUFsUWM9IiwiMTA5MTUwMCIsIm1vc3RfcmVjZW50IiwiZW4iLCJuZWdhdGl2ZSIsInN0ZWFtIixudWxsLG51bGwsbnVsbCwiMTAiLG51bGwsbnVsbCwiMjAiLCIyMCJd"
}
}
Reviews From a Time Period
https://www.searchapi.io/api/v1/search?app_id=523660&engine=steam_reviews&review_type=negative&sort_by=most_recent&time_period_max=2023-11-30&time_period_min=2023-09-01
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "steam_reviews",
"app_id": "523660",
"sort_by": "most_recent",
"review_type": "negative",
"time_period_min": "2023-09-01",
"time_period_max": "2023-11-30"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_siO8Ze7j5deF39zrQgRrA8JN",
"status": "Success",
"created_at": "2026-11-18T14:49:36Z",
"request_time_taken": 3.14,
"parsing_time_taken": 0.0,
"total_time_taken": 3.14,
"request_url": "https://store.steampowered.com/app/523660/",
"html_url": "https://www.searchapi.io/api/v1/searches/search_siO8Ze7j5deF39zrQgRrA8JN.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_siO8Ze7j5deF39zrQgRrA8JN"
},
"search_parameters": {
"engine": "steam_reviews",
"app_id": "523660",
"sort_by": "most_recent",
"review_type": "negative",
"time_period_min": "2023-09-01",
"time_period_max": "2023-11-30"
},
"search_information": {
"total_results": 7
},
"product": {
"app_id": 523660,
"link": "https://store.steampowered.com/app/523660/"
},
"reviews": [
{
"position": 1,
"review_id": "152469693",
"link": "https://steamcommunity.com/profiles/76561198943933556/recommended/523660/",
"text": "no online community",
"is_recommended": false,
"language": "en",
"iso_date": "2023-11-28T20:12:46Z",
"iso_last_updated": "2023-11-28T20:12:46Z",
"helpful_votes": 5,
"funny_votes": 0,
"weighted_vote_score": 0.5173426866531372,
"comments": 0,
"is_steam_purchase": true,
"is_received_for_free": false,
"is_written_during_early_access": false,
"is_primarily_steam_deck": false,
"is_refunded": false,
"user": {
"steam_id": "76561198943933556",
"name": "Cousy",
"link": "https://steamcommunity.com/id/otherkynd/",
"thumbnail": "https://avatars.steamstatic.com/2f9ed5bce6461105c5bb64d2a47c2b358bee9423_full.jpg",
"reviews": 2,
"iso_last_played": "2023-11-26T23:41:45Z",
"playtime": {
"total_minutes": 96,
"last_two_weeks_minutes": 0,
"at_review_minutes": 96
}
},
"response": {
"text": "Hello Cousy,\nThank you so much for giving our game a try! I totally understand the frustration of not finding enough players - it's a challenge we're actively working to improve. As a small indie team of six, our marketing budget is quite l...",
"iso_date": "2023-12-10T17:21:54Z"
}
},
{
"position": 2,
"review_id": "152207103",
"link": "https://steamcommunity.com/profiles/76561198316592452/recommended/523660/",
"text": "Nobody is playing this game.. I mean NOBODY! It has potential but you can't find a single mp match and I tried every damn mode. Easy refund :/",
"is_recommended": false,
"language": "en",
"iso_date": "2023-11-27T10:20:21Z",
"iso_last_updated": "2023-11-27T10:20:21Z",
"helpful_votes": 21,
"funny_votes": 2,
"weighted_vote_score": 0.5446265935897827,
"comments": 6,
"awards": [
{
"title": "Wholesome",
"count": 3,
"thumbnail": "https://store.akamai.steamstatic.com/public/images/loyalty/reactions/still/18.png"
},
{
"title": "Saucy",
"count": 1,
"thumbnail": "https://store.akamai.steamstatic.com/public/images/loyalty/reactions/still/15.png"
}
],
"is_steam_purchase": true,
"is_received_for_free": false,
"is_written_during_early_access": false,
"is_primarily_steam_deck": false,
"is_refunded": false,
"user": {
"steam_id": "76561198316592452",
"name": "AnthraRaven",
"link": "https://steamcommunity.com/profiles/76561198316592452/",
"thumbnail": "https://avatars.steamstatic.com/ec13b8c6db8bacd9335e33e3b8ddd9b68a973563_full.jpg",
"reviews": 4,
"iso_last_played": "2023-11-27T10:13:42Z",
"playtime": {
"total_minutes": 34,
"last_two_weeks_minutes": 0,
"at_review_minutes": 34
}
},
"response": {
"text": "Hi AnthraRaven,\nI completely understand your frustration with the low player base in Hypercharge. We do recommend playing with friends in co-op mode as it's a really fun experience. However, I totally get that it's not always easy to convin...",
"iso_date": "2023-11-28T13:14:26Z"
}
},
{
"position": 3,
"review_id": "152153924",
"link": "https://steamcommunity.com/profiles/76561198405483361/recommended/523660/",
"text": "used to be fun no active servers :(",
"is_recommended": false,
"language": "en",
"iso_date": "2023-11-27T00:27:00Z",
"iso_last_updated": "2023-11-27T00:27:00Z",
"helpful_votes": 0,
"funny_votes": 0,
"weighted_vote_score": 0.4926345646381378,
"comments": 0,
"is_steam_purchase": true,
"is_received_for_free": false,
"is_written_during_early_access": false,
"is_primarily_steam_deck": false,
"is_refunded": false,
"user": {
"steam_id": "76561198405483361",
"name": "monkey pox",
"link": "https://steamcommunity.com/profiles/76561198405483361/",
"thumbnail": "https://avatars.steamstatic.com/c4aab9643e3d7398552c3c4447bbedb7aaa082f0_full.jpg",
"games_owned": 89,
"reviews": 9,
"iso_last_played": "2025-08-20T01:37:13Z",
"playtime": {
"total_minutes": 1489,
"last_two_weeks_minutes": 0,
"at_review_minutes": 1456
}
},
"response": {
"text": "Hi den,\nI totally get your point about finding players – it's not the most enjoyable experience when it's a struggle. We're really putting our all into attracting more players, but it's a tough challenge. As a small team of six indie devs,...",
"iso_date": "2023-12-10T17:21:34Z"
}
},
"..."
]
}