{"components":{"responses":{"Invalid":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid parameters"},"Limited":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit reached; respect Retry-After before retrying","headers":{"Retry-After":{"description":"Seconds before retrying","schema":{"type":"integer"}}}},"Missing":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"},"ReadOnly":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Only GET, HEAD and OPTIONS are allowed"},"Unavailable":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily busy or unavailable","headers":{"Retry-After":{"description":"Seconds before retrying","schema":{"type":"integer"}}}}},"schemas":{"Capabilities":{"type":"object"},"Error":{"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"},"Game":{"properties":{"cover_url":{"type":["string","null"]},"genres":{"items":{"type":"string"},"type":"array"},"identifiers":{"$ref":"#/components/schemas/Identifiers"},"igdb_id":{"type":["integer","null"]},"last_posted":{"type":["string","null"]},"rating":{"type":["number","null"]},"release_count":{"type":"integer"},"release_year":{"type":["integer","null"]},"slug":{"type":"string"},"summary":{"type":["string","null"]},"title":{"type":"string"}},"type":"object"},"GamePage":{"properties":{"games":{"items":{"$ref":"#/components/schemas/Game"},"type":"array"},"limit":{"type":"integer"},"page":{"type":"integer"},"total":{"type":"integer"}},"type":"object"},"Group":{"properties":{"games":{"type":"integer"},"latest":{"type":["string","null"]},"name":{"type":"string"},"p2p":{"type":"integer"},"releases":{"type":"integer"},"scene":{"type":"integer"}},"type":"object"},"GroupPage":{"properties":{"groups":{"items":{"$ref":"#/components/schemas/Group"},"type":"array"},"limit":{"type":"integer"},"page":{"type":"integer"},"total":{"type":"integer"}},"type":"object"},"IdentifierMatches":{"properties":{"games":{"items":{"$ref":"#/components/schemas/Game"},"maxItems":100,"type":"array"}},"type":"object"},"Identifiers":{"properties":{"csrin_urls":{"items":{"format":"uri","type":"string"},"type":"array"},"ids":{"properties":{"csrin":{"items":{"type":"string"},"type":"array"},"epic":{"items":{"type":"string"},"type":"array"},"gog":{"items":{"type":"string"},"type":"array"},"igdb":{"items":{"type":"string"},"type":"array"},"online_fix":{"items":{"type":"string"},"type":"array"},"steam":{"items":{"type":"string"},"type":"array"}},"type":"object"},"online_fix_urls":{"description":"Verified public Online-Fix pages; closed or stale pages are omitted.","items":{"format":"uri","type":"string"},"type":"array"}},"type":"object"},"Nfo":{"properties":{"nfo":{"type":"string"}},"type":"object"},"OpenApi":{"type":"object"},"Release":{"properties":{"added_at":{"type":["string","null"]},"category":{"enum":["full_game","update_fix"],"type":"string"},"cover_url":{"type":["string","null"]},"date":{"type":["string","null"]},"game_slug":{"type":["string","null"]},"group":{"type":["string","null"]},"has_nfo":{"type":"boolean"},"id":{"type":"integer"},"igdb_id":{"type":["integer","null"]},"name":{"type":"string"},"platforms":{"items":{"enum":["windows","linux","macos"],"type":"string"},"type":"array"},"size_bytes":{"type":"integer"},"source":{"enum":["SCENE","P2P"]},"steam_appid":{"type":["integer","null"]}},"type":"object"},"ReleasePage":{"properties":{"limit":{"type":"integer"},"page":{"type":"integer"},"releases":{"items":{"$ref":"#/components/schemas/Release"},"type":"array"},"total":{"type":"integer"}},"type":"object"},"Statistics":{"type":"object"}}},"info":{"description":"Public read-only API, no authentication. 300 requests per rolling 60 seconds per IP. Dates are UTC; missing values remain null. No download preparation or private source URLs.","title":"Arkona API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/":{"get":{"parameters":[],"responses":{"200":{"content":{"application/json":{"example":{"authentication":"none","name":"Arkona API","read_only":true,"requests_per_minute":300,"version":"1"},"schema":{"$ref":"#/components/schemas/Capabilities"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"API capabilities"}},"/games":{"get":{"parameters":[{"description":"Search words; releases/games also support exact:, re:, provider:identifier and known direct game URLs. Providers: igdb, steam (appid/steamdb), gog (gogdb), epic, csrin, online_fix, origin (ea), screamdb, egdata, agru, riotpixels, mobygames, pcgamingwiki, hltb, itad, canirunit, gamecopyworld. Numeric IDs or URL identifiers as appropriate; only stored associations are searched. Maximum 512 bytes (128 for groups).","in":"query","name":"q","schema":{"type":"string"}},{"description":"1-based; pages beyond the result set return the last page.","in":"query","name":"page","schema":{"default":1,"maximum":1000000,"minimum":1,"type":"integer"}},{"in":"query","name":"limit","schema":{"default":50,"maximum":100,"minimum":1,"type":"integer"}},{"description":"SCENE or P2P","in":"query","name":"source","schema":{"type":"string"}},{"description":"Exact group name, case-insensitive","in":"query","name":"group","schema":{"type":"string"}},{"description":"Alias for group","in":"query","name":"team","schema":{"type":"string"}},{"description":"Minimum size in GiB","in":"query","name":"size_min","schema":{"type":"number"}},{"description":"Maximum size in GiB","in":"query","name":"size_max","schema":{"type":"number"}},{"description":"YYYY-MM-DD, inclusive UTC","in":"query","name":"date_min","schema":{"type":"string"}},{"description":"YYYY-MM-DD, inclusive UTC","in":"query","name":"date_max","schema":{"type":"string"}},{"description":"yes or no","in":"query","name":"nfo","schema":{"type":"string"}},{"description":"yes: IGDB, Steam, GOG or Epic identity; no: none of these. Legacy igdb, steam and none are also supported.","in":"query","name":"metadata","schema":{"type":"string"}},{"description":"1 to require a cover","in":"query","name":"with_cover","schema":{"type":"integer"}},{"description":"yes for a nonblank game cover, no for a missing/blank cover, any or omitted for all. Overrides with_cover when yes or no. Supported in RSS.","in":"query","name":"cover","schema":{"type":"string"}},{"description":"1 to require an unknown size","in":"query","name":"unknown_size","schema":{"type":"integer"}},{"description":"date (default), title (ascending), rating (descending), most_releases (descending)","in":"query","name":"sort","schema":{"type":"string"}},{"description":"Name-derived filter using case-insensitive substrings. update, crackfix and trainer are exclusive statistics kinds with precedence trainer > crackfix > update; full_game includes all remaining names. update_fix still includes all three non-full-game kinds. Omitted or empty includes all releases. Response category remains full_game or update_fix.","in":"query","name":"category","schema":{"enum":["","full_game","update_fix","update","crackfix","trainer"],"type":"string"}},{"description":"any (default, omitted or empty) does not filter. yes requires a stored, nonblank matched srrDB release name. no means no known confirmed link, including unchecked, pending, deferred or failed lookups, not only checked releases with no match. Combines with source=SCENE and other release filters. Does not trigger an external lookup.","in":"query","name":"srrdb","schema":{"default":"any","enum":["","any","yes","no"],"type":"string"}},{"description":"any (default, omitted or empty) does not filter. yes requires a known reference on srrDB, PreDB.net, xREL, a verified archive or an exact public PreDB.fr entry for the current release name. PreDB.fr entries imported from Arkona do not establish independent Scene group trust. no includes all releases without such a reference, including pending or failed lookups. A date or NFO alone is not a match. Combines with source=SCENE and all search filters, including RSS. Does not trigger an external lookup. The srrdb parameter remains srrDB-only.","in":"query","name":"scene_reference","schema":{"default":"any","enum":["","any","yes","no"],"type":"string"}},{"description":"windows, macos or linux from IGDB/Steam game metadata, not release filenames.","in":"query","name":"game_platform","schema":{"type":"string"}},{"description":"Exact stored game genre, maximum 128 bytes. RPG/Role-playing (RPG), Simulation/Simulator and Sports/Sport are equivalent. Combines with search, game platform, dates and pagination.","in":"query","name":"game_genre","schema":{"type":"string"}},{"description":"Game release date from YYYY-MM-DD inclusive. IGDB first_release_date, then Steam date, then known release year. Year-only dates match if the year overlaps the range; unknown dates are excluded. Never uses the release upload/original date.","in":"query","name":"game_date_min","schema":{"type":"string"}},{"description":"Game release date through YYYY-MM-DD inclusive; same game metadata and year precision as game_date_min.","in":"query","name":"game_date_max","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"games":[],"limit":50,"page":1,"total":0},"schema":{"$ref":"#/components/schemas/GamePage"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"Search games"}},"/games/{slug}":{"get":{"parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"identifiers":{"csrin_urls":[],"ids":{"csrin":[],"epic":[],"gog":[],"igdb":[],"online_fix":[],"steam":[]},"online_fix_urls":[]},"slug":"example","title":"Example"},"schema":{"$ref":"#/components/schemas/Game"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"Game metadata and identifiers"}},"/groups":{"get":{"parameters":[{"description":"Search words; releases/games also support exact:, re:, provider:identifier and known direct game URLs. Providers: igdb, steam (appid/steamdb), gog (gogdb), epic, csrin, online_fix, origin (ea), screamdb, egdata, agru, riotpixels, mobygames, pcgamingwiki, hltb, itad, canirunit, gamecopyworld. Numeric IDs or URL identifiers as appropriate; only stored associations are searched. Maximum 512 bytes (128 for groups).","in":"query","name":"q","schema":{"type":"string"}},{"description":"1-based; pages beyond the result set return the last page.","in":"query","name":"page","schema":{"default":1,"maximum":1000000,"minimum":1,"type":"integer"}},{"in":"query","name":"limit","schema":{"default":50,"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"groups":[],"limit":50,"page":1,"total":0},"schema":{"$ref":"#/components/schemas/GroupPage"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"Group directory"}},"/groups/{name}":{"get":{"parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"name":"RUNE","p2p":0,"releases":10,"scene":10},"schema":{"$ref":"#/components/schemas/Group"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"Group statistics"}},"/identifiers/{provider}/{id}":{"get":{"parameters":[{"in":"path","name":"provider","required":true,"schema":{"enum":["igdb","steam","gog","epic","csrin","online_fix"],"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"games":[]},"schema":{"$ref":"#/components/schemas/IdentifierMatches"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"Resolve an exact provider ID"}},"/openapi.json":{"get":{"parameters":[],"responses":{"200":{"content":{"application/json":{"example":{"openapi":"3.1.0"},"schema":{"$ref":"#/components/schemas/OpenApi"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"OpenAPI specification"}},"/releases":{"get":{"parameters":[{"description":"Search words; releases/games also support exact:, re:, provider:identifier and known direct game URLs. Providers: igdb, steam (appid/steamdb), gog (gogdb), epic, csrin, online_fix, origin (ea), screamdb, egdata, agru, riotpixels, mobygames, pcgamingwiki, hltb, itad, canirunit, gamecopyworld. Numeric IDs or URL identifiers as appropriate; only stored associations are searched. Maximum 512 bytes (128 for groups).","in":"query","name":"q","schema":{"type":"string"}},{"description":"1-based; pages beyond the result set return the last page.","in":"query","name":"page","schema":{"default":1,"maximum":1000000,"minimum":1,"type":"integer"}},{"in":"query","name":"limit","schema":{"default":50,"maximum":100,"minimum":1,"type":"integer"}},{"description":"SCENE or P2P","in":"query","name":"source","schema":{"type":"string"}},{"description":"Exact group name, case-insensitive","in":"query","name":"group","schema":{"type":"string"}},{"description":"Alias for group","in":"query","name":"team","schema":{"type":"string"}},{"description":"Minimum size in GiB","in":"query","name":"size_min","schema":{"type":"number"}},{"description":"Maximum size in GiB","in":"query","name":"size_max","schema":{"type":"number"}},{"description":"YYYY-MM-DD, inclusive UTC","in":"query","name":"date_min","schema":{"type":"string"}},{"description":"YYYY-MM-DD, inclusive UTC","in":"query","name":"date_max","schema":{"type":"string"}},{"description":"yes or no","in":"query","name":"nfo","schema":{"type":"string"}},{"description":"yes: IGDB, Steam, GOG or Epic identity; no: none of these. Legacy igdb, steam and none are also supported.","in":"query","name":"metadata","schema":{"type":"string"}},{"description":"1 to require a cover","in":"query","name":"with_cover","schema":{"type":"integer"}},{"description":"yes for a nonblank game cover, no for a missing/blank cover, any or omitted for all. Overrides with_cover when yes or no. Supported in RSS.","in":"query","name":"cover","schema":{"type":"string"}},{"description":"1 to require an unknown size","in":"query","name":"unknown_size","schema":{"type":"integer"}},{"description":"date (JSON default), added (RSS default), name, size, group","in":"query","name":"sort","schema":{"type":"string"}},{"description":"Name-derived filter using case-insensitive substrings. update, crackfix and trainer are exclusive statistics kinds with precedence trainer > crackfix > update; full_game includes all remaining names. update_fix still includes all three non-full-game kinds. Omitted or empty includes all releases. Response category remains full_game or update_fix.","in":"query","name":"category","schema":{"enum":["","full_game","update_fix","update","crackfix","trainer"],"type":"string"}},{"description":"any (default, omitted or empty) does not filter. yes requires a stored, nonblank matched srrDB release name. no means no known confirmed link, including unchecked, pending, deferred or failed lookups, not only checked releases with no match. Combines with source=SCENE and other release filters. Does not trigger an external lookup.","in":"query","name":"srrdb","schema":{"default":"any","enum":["","any","yes","no"],"type":"string"}},{"description":"any (default, omitted or empty) does not filter. yes requires a known reference on srrDB, PreDB.net, xREL, a verified archive or an exact public PreDB.fr entry for the current release name. PreDB.fr entries imported from Arkona do not establish independent Scene group trust. no includes all releases without such a reference, including pending or failed lookups. A date or NFO alone is not a match. Combines with source=SCENE and all search filters, including RSS. Does not trigger an external lookup. The srrdb parameter remains srrDB-only.","in":"query","name":"scene_reference","schema":{"default":"any","enum":["","any","yes","no"],"type":"string"}},{"description":"asc or desc (default)","in":"query","name":"order","schema":{"type":"string"}},{"description":"json (default), rss or xml. RSS uses the same filters, defaults to newest site publications and links to Arkona pages, never source files. pubDate is the site publication date; the original date is in the description. Suggested polling interval: 60 minutes.","in":"query","name":"format","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"limit":50,"page":1,"releases":[],"total":0},"schema":{"$ref":"#/components/schemas/ReleasePage"}},"application/rss+xml":{"schema":{"type":"string"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"Search releases"}},"/releases/nfo":{"get":{"parameters":[{"in":"query","name":"name","required":true,"schema":{"maxLength":512,"type":"string"}},{"description":"Optional SCENE or P2P filter","in":"query","name":"source","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"nfo":"NFO text"},"schema":{"$ref":"#/components/schemas/Nfo"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"413":{"description":"NFO exceeds 1 MiB"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"NFO as JSON"}},"/releases/nfo/download":{"get":{"parameters":[{"in":"query","name":"name","required":true,"schema":{"maxLength":512,"type":"string"}},{"description":"Optional SCENE or P2P filter","in":"query","name":"source","schema":{"type":"string"}}],"responses":{"200":{"content":{"text/plain":{"example":"NFO text","schema":{"type":"string"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"413":{"description":"NFO exceeds 1 MiB"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"Download UTF-8 NFO"}},"/releases/{name}":{"get":{"parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"has_nfo":false,"name":"Example-RUNE","source":"SCENE"},"schema":{"$ref":"#/components/schemas/Release"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"Release by exact name"}},"/stats":{"get":{"parameters":[],"responses":{"200":{"content":{"application/json":{"example":{"stats":{"releases":0},"years":[]},"schema":{"$ref":"#/components/schemas/Statistics"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the oldest request leaves the rolling window","schema":{"type":"integer"}}}},"400":{"$ref":"#/components/responses/Invalid"},"404":{"$ref":"#/components/responses/Missing"},"405":{"$ref":"#/components/responses/ReadOnly"},"429":{"$ref":"#/components/responses/Limited"},"503":{"$ref":"#/components/responses/Unavailable"}},"summary":"Catalog statistics (cached 60 seconds)"}}},"security":[],"servers":[{"url":"/api/v1"}]}