{"openapi":"3.1.0","info":{"title":"ProtonDB Steam Deck & Linux Compatibility API","version":"1.0.0","description":"Live Linux and Steam Deck compatibility plus popularity for Steam games, from the public ProtonDB and Steam feeds — no key, nothing stored. The \"can I play it on Linux / Steam Deck, and is anyone playing it\" view of a game: the crowd-sourced ProtonDB compatibility tier together with the live concurrent-player count, distinct from the other game and platform APIs in the catalogue. The game endpoint returns a full picture for a title — its Steam name, genres and release date, the ProtonDB compatibility tier (platinum, gold, silver, bronze or borked) with the community confidence, score and report count, the trending and best-reported tiers, and the live player count. The search endpoint resolves a game name to its Steam app id and other matches, so you can find the id to query. The players endpoint returns just the live concurrent-player count for a game. Build Steam Deck compatibility checkers, Linux gaming dashboards, \"is it playable\" widgets and game-popularity trackers on top of real ProtonDB and Steam data. Look up a game by Steam app id (appid=1245620) or by name (name=elden ring); ProtonDB tiers run from platinum (flawless) down to borked, and player counts are live.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/protondb-api","description":"oanor gateway"}],"tags":[{"name":"Game"},{"name":"Search"},{"name":"Players"},{"name":"Meta"},{"name":"Games"},{"name":"Community"},{"name":"Charts"}],"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/game":{"get":{"operationId":"get_v1_game","tags":["Game"],"summary":"Full game picture — compatibility + players","description":"","parameters":[{"name":"appid","in":"query","required":false,"description":"Steam app id (or pass name=)","schema":{"type":"string"},"example":"1245620"},{"name":"name","in":"query","required":false,"description":"Game name (resolved via Steam search)","schema":{"type":"string"},"example":"elden ring"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"ELDEN RING","appid":1245620,"genres":["Action","RPG"],"source":"ProtonDB + Steam","released":"24 Feb, 2022","current_players":29376,"steam_deck_linux":{"tier":"gold","score":0.78,"confidence":"strong","total_reports":2058,"trending_tier":"platinum","best_reported_tier":"platinum"}},"meta":{"timestamp":"2026-06-12T01:42:28.537Z","request_id":"f7144857-5948-47e7-8a16-75d8109e2bce"},"status":"ok","message":"Game 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 Steam app ids","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"zelda"},{"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,"query":"portal","source":"Steam","results":[{"name":"Portal 2","type":"app","appid":620},{"name":"Portal","type":"app","appid":400},{"name":"Portal Knights","type":"app","appid":374040},{"name":"Portal Worlds","type":"app","appid":4327940},{"name":"Bridge Constructor Portal","type":"app","appid":684410},{"name":"Bridge Constructor Portal - Portal Proficiency","type":"app","appid":1113550},{"name":"Portal Reloaded","type":"app","appid":1255980},{"name":"Portal Dungeon","type":"app","appid":1679220},{"name":"Portal: Revolution","type":"app","appid":601360},{"name":"Desktop Portal","type":"app","appid":1178460}]},"meta":{"timestamp":"2026-06-12T01:42:28.886Z","request_id":"685d9c6e-b87f-4da2-922c-bc9b8521820f"},"status":"ok","message":"Search 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/players":{"get":{"operationId":"get_v1_players","tags":["Players"],"summary":"Live concurrent-player count for a game","description":"","parameters":[{"name":"appid","in":"query","required":false,"description":"Steam app id (or pass name=)","schema":{"type":"string"},"example":"1245620"},{"name":"name","in":"query","required":false,"description":"Game name (alternative to appid)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Counter-Strike 2","appid":730,"source":"Steam","current_players":501523},"meta":{"timestamp":"2026-06-12T01:42:29.169Z","request_id":"9ae52b96-3958-436a-8b6b-607c32bc8a0c"},"status":"ok","message":"Players 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":{"note":"Look up a game by Steam app id (appid=1245620) or by name (name=elden ring, resolved via Steam search). ProtonDB tiers: platinum (flawless), gold, silver, bronze, borked. current_players is the live concurrent count from Steam.","source":"ProtonDB (protondb.com/api) and Steam public feeds (steampowered.com, live)","service":"protondb-api","endpoints":{"GET /v1/game":"Full game picture — ProtonDB tier, genres, live players (appid=1245620 or name=elden ring).","GET /v1/meta":"This document.","GET /v1/search":"Resolve a game name to Steam app ids (q=zelda).","GET /v1/players":"Live concurrent-player count for a game (appid=1245620 or name=dota 2)."},"description":"Live Linux & Steam Deck compatibility plus popularity for Steam games, from the public ProtonDB and Steam feeds. The 'can I play it on Linux / Steam Deck, and is anyone playing it' view. game = a full picture (Steam name, genres, release date, the ProtonDB compatibility tier — platinum/gold/silver/bronze/borked — with community confidence, score, report count, trending and best-reported tiers, and the live player count); search = resolves a game name to its Steam app id and other matches; players = just the live concurrent-player count for a game. Live, no key, nothing stored. Distinct from the other game and platform APIs.","sample_players":29376,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T01:42:29.272Z","request_id":"d00c3f44-7856-4029-9b88-8cdc93ba27f2"},"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"}}}},"/v1/news":{"get":{"operationId":"get_v1_news","tags":["Community"],"summary":"Latest news and announcements for a game","description":"","parameters":[{"name":"appid","in":"query","required":false,"description":"Steam app id (or pass name=)","schema":{"type":"string"},"example":"1245620"},{"name":"name","in":"query","required":false,"description":"Game name (alternative to appid)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max items (1-20)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"news":[{"url":"https://steamstore-a.akamaihd.net/news/externalpost/Gamemag.ru/1834602721191360","date":"2026-06-05T01:34:00.000Z","feed":"Gamemag.ru","title":"Официально: Полная версия ELDEN RING нагрянет на Nintendo Switch 2 в августе — игроки с других платформ смогут докупить новый контент","author":"Deacon","summary":"FromSoftware объявила дату выхода Elden Ring: Tarnished Edition для Nintendo Switch 2 . Самая полная версия знаменитой RPG поступит в продажу 28 августа 2026 года ."},{"url":"https://steamstore-a.akamaihd.net/news/externalpost/Gamemag.ru/1833968530894248","date":"2026-05-30T20:05:00.000Z","feed":"Gamemag.ru","title":"Дизайнер Tomb Raider: Legacy of Atlantis рассказал, чему все разработчики могут научиться у FromSoftware","author":"Семен Страндов","summary":"Геймдизайнер Tomb Raider: Legacy of Atlantis Марцин Матушчик высказался в пользу более внимательной и продуманной реализации боевой системы и сражений с боссами в современных играх."},{"url":"https://steamstore-a.akamaihd.net/news/externalpost/steam_community_announcements/1832700592786543","date":"2026-05-13T14:20:38.000Z","feed":"Community Announcements","title":"ELDEN RING - RAGING WOLF 1/6 SCALE STATUE","author":"[BNE] *****","summary":"Who is the Raging Wolf? Among the first Tarnished to join the Roundtable Hold was Vargram, a warrior of great skill and ferocity. He acquired the title of the Raging Wolf from the white wolf pelt that flowed from his helm. Vargram sought to become the shadow of one of the Empyreans and built his strength relentlessly as he traveled through fallow Limgrave to the golden city of Leyndell. And yet in"},{"url":"https://steamstore-a.akamaihd.net/news/externalpost/Rock, Paper, Shotgun/1832065502812069","date":"2026-05-07T10:54:14.000Z","feed":"Rock, Paper, Shotgun","title":"Morrowind in Elden Ring mod is now \"mostly playable\", despite the fact its creator's \"entire existence has been consumed with interpreting gibberish code\"","summary":"Regular RPS readers might remember me writing a couple of times last year about a modder kicking off an attempt at porting Morrowind into Elden Ring . Their early progress looked promising, if living under the cloud of several complex things the group would have to figure out in some form to get it working. After about half a year of major updateless silence, modder InfernoPlus has emerged from th"},{"url":"https://steamstore-a.akamaihd.net/news/externalpost/steam_community_announcements/1830163047259363","date":"2026-04-17T08:00:23.000Z","feed":"Community Announcements","title":"ELDEN RING: SHADOW OF THE ERDTREE – Official Vinyl Soundtrack","author":"[BNE] *****","summary":"Follow in the foosteps of Miquella once more with this exclusive 2 disc vinyl collection, celebrating the sweeping, emotional journey of Shadow of the Erdtree. Presented with the reverence merited by a legendary expansion, this premium set is crafted for collectors, audiophiles, and Tarnished who seek to experience the Realm of Shadow through its music. The Collection Housed in a full color gatefo"}],"appid":1245620,"count":5,"source":"Steam"},"meta":{"timestamp":"2026-06-13T13:54:55.312Z","request_id":"b4c72da2-3c88-4eed-90d6-e3095a264fed"},"status":"ok","message":"News 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/reviews":{"get":{"operationId":"get_v1_reviews","tags":["Community"],"summary":"Steam community reviews + sentiment summary","description":"","parameters":[{"name":"appid","in":"query","required":false,"description":"Steam app id (or pass name=)","schema":{"type":"string"},"example":"1245620"},{"name":"name","in":"query","required":false,"description":"Game name (alternative to appid)","schema":{"type":"string"}},{"name":"filter","in":"query","required":false,"description":"recent (default), updated or all","schema":{"type":"string"},"example":"recent"},{"name":"limit","in":"query","required":false,"description":"Max reviews (1-25)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"ELDEN RING","appid":1245620,"count":10,"filter":"recent","source":"Steam","reviews":[{"review":"Look majestic tree is there","created":"2026-06-13T12:37:57.000Z","voted_up":true,"votes_up":0,"votes_funny":0,"on_steam_deck":false,"playtime_hours":121,"steam_purchase":false,"playtime_at_review_hours":121},{"review":"[h1]Open world yay...or nay[/h1] Here we go another entry in dark/demon souls series. But it's elden souls now. So this time they made dark souls open world. Story? As always there's none, just some nonsensical characters around speaking in riddles and rubbish in general. Open world is very static and feels dead. There are enemies copy pasted everywhere though. With some stationary npc's who apparently are immortal and not afraid of any danger. Oh wait you can kill them so they're mortal but not","created":"2026-06-13T12:18:39.000Z","voted_up":false,"votes_up":1,"votes_funny":0,"on_steam_deck":false,"playtime_hours":116,"steam_purchase":false,"playtime_at_review_hours":116},{"review":"Best game ever made","created":"2026-06-13T12:13:08.000Z","voted_up":true,"votes_up":0,"votes_funny":0,"on_steam_deck":false,"playtime_hours":313,"steam_purchase":true,"playtime_at_review_hours":313},{"review":"uuuuuuuhhhhhhhhhhh I guess","created":"2026-06-13T12:02:44.000Z","voted_up":true,"votes_up":0,"votes_funny":0,"on_steam_deck":true,"playtime_hours":186,"steam_purchase":false,"playtime_at_review_hours":186},{"review":"Greatest Game OAT","created":"2026-06-13T11:38:14.000Z","voted_up":true,"votes_up":0,"votes_funny":0,"on_steam_deck":false,"playtime_hours":419,"steam_purchase":true,"playtime_at_review_hours":418},{"review":"What are you looking at? Buy it","created":"2026-06-13T11:25:47.000Z","voted_up":true,"votes_up":0,"votes_funny":0,"on_steam_deck":false,"playtime_hours":347,"steam_purchase":false,"playtime_at_review_hours":347},{"review":"Elden Ring is a rlly great game if you like to get killed and bullied and if you hate your live and if you like cool boses and open world its also great over all nice game","created":"2026-06-13T11:23:12.000Z","voted_up":true,"votes_up":0,"votes_funny":0,"on_steam_deck":false,"playtime_hours":36,"steam_purchase":false,"playtime_at_review_hours":34},{"review":"paying 60 euros to get brutally touched might be the best investment u can make","created":"2026-06-13T10:56:40.000Z","voted_up":true,"votes_up":0,"votes_funny":0,"on_steam_deck":false,"playtime_hours":202,"steam_purchase":true,"playtime_at_review_hours":202},{"review":"Overall a great game not to hard if u spend the time to learn it i myself was able to beat it within 50 hrs with no guides.However,this was mainly focoused on the main story.I did kill all remeberances bosses do vares quest.This game has a wide versatil build options wich scale the difficulty quite significantly. if you are strugling you can use a bleed build or you could use a mage or faith build but if u want the best exprience i reccomend strenght as it means u have to learn the bosses movset","created":"2026-06-13T10:52:20.000Z","voted_up":true,"votes_up":0,"votes_funny":0,"on_steam_deck":false,"playtime_hours":60,"steam_purchase":false,"playtime_at_review_hours":60},{"review":"Play it","created":"2026-06-13T10:48:48.000Z","voted_up":true,"votes_up":0,"votes_funny":0,"on_steam_deck":false,"playtime_hours":488,"steam_purchase":true,"playtime_at_review_hours":488}],"summary":{"positive_pct":94,"total_reviews":563804,"total_negative":33993,"total_positive":529811,"review_score_desc":"Very Positive"}},"meta":{"timestamp":"2026-06-13T13:54:55.603Z","request_id":"73d1bcf6-379e-4114-8bb6-d4b6d2b3d08c"},"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/charts":{"get":{"operationId":"get_v1_charts","tags":["Charts"],"summary":"The most-played Steam games right now","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max games (1-25)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"games":[{"name":"Counter-Strike 2","rank":1,"appid":730,"rank_change":0,"peak_players":1275982},{"name":"PUBG: BATTLEGROUNDS","rank":2,"appid":578080,"rank_change":0,"peak_players":732248},{"name":"Dota 2","rank":3,"appid":570,"rank_change":0,"peak_players":635321},{"name":"Wallpaper Engine","rank":4,"appid":431960,"rank_change":0,"peak_players":111342},{"name":"Apex Legends™","rank":5,"appid":1172470,"rank_change":1,"peak_players":284062},{"name":"Slay the Spire 2","rank":6,"appid":2868840,"rank_change":-1,"peak_players":196023},{"name":"R.E.P.O.","rank":7,"appid":3241660,"rank_change":22,"peak_players":94560},{"name":"Grand Theft Auto V Legacy","rank":8,"appid":271590,"rank_change":-1,"peak_players":98540},{"name":"FiveM","rank":9,"appid":2676230,"rank_change":-1,"peak_players":192252},{"name":"Geometry Dash","rank":10,"appid":322170,"rank_change":-1,"peak_players":68410}],"source":"Steam"},"meta":{"timestamp":"2026-06-13T13:54:56.132Z","request_id":"81d728a6-5420-4360-bbdc-7b0e80c15ac6"},"status":"ok","message":"Charts 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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":21000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":540,"monthly_call_quota":290000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1580,"monthly_call_quota":1200000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":3640,"monthly_call_quota":4200000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/protondb-api"}