The Ascendara API at api.ascendara.app powers the Ascendara app. Its public endpoints give you read access to the official game index, game metadata and update checks, community ratings and view counts, release information, and a few other data sources. You can use them in your own non-commercial projects.
The API never hosts game files. Download links in the index point to third-party file hosts.
Basics
Base URL
https://api.ascendara.app
Format
JSON, except image endpoints (which return the image)
Authentication
None for the endpoints documented here
Usage
Non-commercial use only
bash
curl https://api.ascendara.app/
json
{"appVer":"11.5.3","status":"OK","readme":"This is the public API for Ascendara. Only available for non-commercial use","documentation":"https://ascendara.app/docs/api-reference/overview"}
Fair Use
Cache what you download. The full game list is several megabytes. It supports ETag/If-None-Match, so a repeat request costs almost nothing when the list hasn't changed. The index is refreshed on a schedule; polling it more than every few minutes gains you nothing.
Batch when you can. To check updates for many games, use POST /v3/games/checkupdates instead of one request per game.
Expect rate limits. Limits are per IP address. Going over returns 429 (see Error Handling). IPs that keep abusing the API can be blocked.
Don't rely on undocumented endpoints. Ascendara also uses endpoints that need signed requests from official builds or a signed-in account (reports, ratings, Ascend, cloud backups, index uploads). Those can change at any time and aren't covered here.