{"openapi":"3.1.0","info":{"title":"Steam Reviews API","version":"1.0.0","description":"Live Steam user-review sentiment as an API — what players really think of any game on Steam, served from Steam's public review data. For any game, looked up by its Steam app id or by name, it returns the aggregate review summary (total reviews, positive and negative counts, the positive percentage and Steam's own rating label such as \"Very Positive\" or \"Mixed\"), plus a sample of recent reviews with their text, whether the author recommends the game, helpful and funny votes, the author's playtime and the review language. Get the full reviews feed, the lightweight sentiment summary, or search Steam to resolve a game name to its app id. The community-sentiment layer for gaming, review and dashboard apps. Live, no key. Distinct from a Steam store-catalogue API — this returns the user reviews and rating sentiment, not the store listing.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/steamreviews-api","description":"oanor gateway"}],"tags":[{"name":"Reviews"},{"name":"Summary"},{"name":"Search"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/reviews":{"get":{"operationId":"get_v1_reviews","tags":["Reviews"],"summary":"Review summary + sample reviews for a game","description":"","parameters":[{"name":"appid","in":"query","required":false,"description":"Steam app id","schema":{"type":"string"},"example":"730"},{"name":"game","in":"query","required":false,"description":"Game name (resolved via search)","schema":{"type":"string"},"example":"Portal 2"},{"name":"filter","in":"query","required":false,"description":"recent|updated|all","schema":{"type":"string"},"example":"recent"},{"name":"type","in":"query","required":false,"description":"all|positive|negative","schema":{"type":"string"},"example":"all"},{"name":"limit","in":"query","required":false,"description":"Reviews to return (1-50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"appid":730,"count":10,"filter":"recent","reviews":[{"id":"227526172","text":"GG!","created":"2026-06-08T23:44:02.000Z","comments":0,"language":"russian","votes_up":0,"recommends":true,"votes_funny":0,"early_access":false,"playtime_hours":35.4,"steam_purchase":true},{"id":"227526153","text":"oyun hep hile dolu","created":"2026-06-08T23:43:41.000Z","comments":0,"language":"turkish","votes_up":1,"recommends":false,"votes_funny":0,"early_access":false,"playtime_hours":183.2,"steam_purchase":true},{"id":"227526132","text":"good gme","created":"2026-06-08T23:43:04.000Z","comments":0,"language":"norwegian","votes_up":0,"recommends":true,"votes_funny":0,"early_access":false,"playtime_hours":142.2,"steam_purchase":true},{"id":"227526080","text":"muito HACK","created":"2026-06-08T23:41:49.000Z","comments":0,"language":"brazilian","votes_up":0,"recommends":true,"votes_funny":0,"early_access":false,"playtime_hours":230.9,"steam_purchase":true},{"id":"227526072","text":"Ну норм 2026 обнова 67695242","created":"2026-06-08T23:41:42.000Z","comments":0,"language":"russian","votes_up":0,"recommends":true,"votes_funny":0,"early_access":false,"playtime_hours":757.7,"steam_purchase":true},{"id":"227526015","text":"não compensa gastar dinheiro comprando o prime nesse lixo de jogo porque tem hack com e sem prime toda partida de 3 a 9 xiters na partida nao da vontade nenhuma de jogar se torna broxante e dps o povo se pergunta pq esse jogo tem menos player q o jogo de magia do valorant, antxit desse jogo e inexistente, se você for jogar use hack se nao, nao vai conseguir jogar e vai desinstalar o game igual eu fiz","created":"2026-06-08T23:40:41.000Z","comments":0,"language":"brazilian","votes_up":0,"recommends":false,"votes_funny":0,"early_access":false,"playtime_hours":86.8,"steam_purchase":true},{"id":"227526013","text":"//","created":"2026-06-08T23:40:40.000Z","comments":0,"language":"russian","votes_up":0,"recommends":true,"votes_funny":0,"early_access":false,"playtime_hours":7.3,"steam_purchase":true},{"id":"227525995","text":"hyvä peli","created":"2026-06-08T23:40:17.000Z","comments":0,"language":"finnish","votes_up":0,"recommends":true,"votes_funny":0,"early_access":false,"playtime_hours":183.9,"steam_purchase":true},{"id":"227525980","text":"jó jatek hee, csak sok a csaló","created":"2026-06-08T23:39:58.000Z","comments":0,"language":"hungarian","votes_up":1,"recommends":true,"votes_funny":0,"early_access":false,"playtime_hours":99.3,"steam_purchase":true},{"id":"227525939","text":"gg","created":"2026-06-08T23:39:05.000Z","comments":0,"language":"english","votes_up":0,"recommends":true,"votes_funny":0,"early_access":false,"playtime_hours":49.3,"steam_purchase":true}],"summary":{"rating":"Very Positive","negative":1339108,"positive":8309286,"positive_pct":86.1,"review_score":8,"total_reviews":9648394},"review_type":"all"},"meta":{"timestamp":"2026-06-09T03:02:33.900Z","request_id":"51f92a5f-a882-43d0-8c9e-fe3d7240ab7a"},"status":"ok","message":"Reviews retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/summary":{"get":{"operationId":"get_v1_summary","tags":["Summary"],"summary":"Aggregate review sentiment for a game","description":"","parameters":[{"name":"appid","in":"query","required":false,"description":"Steam app id","schema":{"type":"string"},"example":"730"},{"name":"game","in":"query","required":false,"description":"Game name","schema":{"type":"string"},"example":"Counter-Strike 2"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"appid":730,"summary":{"rating":"Very Positive","negative":1339108,"positive":8309286,"positive_pct":86.1,"review_score":8,"total_reviews":9648394}},"meta":{"timestamp":"2026-06-09T03:02:34.305Z","request_id":"f145c3c0-5566-41a9-be95-881f976c1ab0"},"status":"ok","message":"Summary retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Resolve a game name to its Steam app id","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Game name query","schema":{"type":"string"},"example":"portal"},{"name":"limit","in":"query","required":false,"description":"Max results (1-25)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"games":[{"name":"Portal 2","appid":620,"image":"https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/620/capsule_231x87.jpg?t=1745363004"},{"name":"Portal","appid":400,"image":"https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/400/capsule_231x87.jpg?t=1745368554"},{"name":"Portal Knights","appid":374040,"image":"https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/374040/capsule_231x87.jpg?t=1696604379"},{"name":"Portal Worlds","appid":4327940,"image":"https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/4327940/ef142efa2df2bcfd2f44185774aa17516836ef59/capsule_231x87.jpg?t=1777889435"},{"name":"Bridge Constructor Portal","appid":684410,"image":"https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/684410/capsule_231x87.jpg?t=1717674640"},{"name":"Bridge Constructor Portal - Portal Proficiency","appid":1113550,"image":"https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/1113550/capsule_231x87.jpg?t=1717674841"},{"name":"Portal Dungeon","appid":1679220,"image":"https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/1679220/capsule_231x87.jpg?t=1765534420"},{"name":"Portal: Revolution","appid":601360,"image":"https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/601360/072c9e764f4e3c1d7a9b832741e4eda033665860/capsule_231x87.jpg?t=1764365933"},{"name":"Portal Reloaded","appid":1255980,"image":"https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/1255980/adfcc8b3d04456d391b99cb01372b321cdb987f4/capsule_231x87.jpg?t=1732736194"},{"name":"Desktop Portal","appid":1178460,"image":"https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/1178460/capsule_231x87.jpg?t=1723269661"}],"query":"portal"},"meta":{"timestamp":"2026-06-09T03:02:34.634Z","request_id":"5b8ee08d-a0c8-48b4-90ec-d591efd4da18"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Steam public appreviews + storesearch (live)","service":"steamreviews-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/search":"Resolve a game name to its Steam app id (q=portal).","GET /v1/reviews":"Review summary + sample reviews (appid=730 or game=Counter-Strike; filter=recent|updated|all, type=all|positive|negative, limit).","GET /v1/summary":"Aggregate review sentiment only (appid or game)."},"description":"Live Steam user-review sentiment: for any game (by Steam app id or name), the aggregate review summary (total, positive/negative counts, positive percentage and Steam's rating label like \"Very Positive\") plus a sample of recent reviews with text, recommendation, helpful/funny votes, author playtime and language. Get the reviews feed, the sentiment summary, or search Steam to resolve a name to an app id. Live, no key. Distinct from a Steam store-catalogue API — this is the user reviews and rating sentiment layer.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:02:34.970Z","request_id":"3a7566e0-c5fb-4c3e-bec1-5b7d0fcd31a0"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":11000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":140000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1900,"monthly_call_quota":720000,"rps_limit":40,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4500,"monthly_call_quota":3600000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/steamreviews-api"}