Skip to main content
Skip to content
Docs/Overview

Ascendara API Overview

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 URLhttps://api.ascendara.app
FormatJSON, except image endpoints (which return the image)
AuthenticationNone for the endpoints documented here
UsageNon-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.

Rate Limits

EndpointsLimit per IP
Images (/v2/image/...)30 per minute
POST /v3/games/checkupdates60 per minute
GET /app/v1/gameviews30 per minute
POST /site/feedback2 per minute
Everything else documented hereNo fixed limit. Be reasonable

Endpoints

App and Status

EndpointReturns
GET /Latest Ascendara version
GET /branch-versionsLatest version on each release branch
GET /app/brokenversionsVersions with known critical issues
GET /downloader-versionCurrent download manager version
GET /healthAPI status and version

Game Index

EndpointReturns
GET /json/v2/gamesThe full game list
GET /v3/game/{gameID}A game's name
GET /v3/game/checkupdate/{gameID}Whether a game has an update
POST /v3/games/checkupdatesUpdate checks for up to 200 games
GET /json/v2/timemachine/{gameID}Every version of a game the index has seen
GET /v2/image/{imgID}A game's cover image
GET /v2/image?place={rank}Cover of the game at a popularity rank
GET /v3/verifiedgamesIDs of Verified games
GET /json/featured-gameThe featured game
GET /localindex/statusWhether the index is refreshing normally
GET /localindex/infoDate, size, and game count of the index

Community Data

EndpointReturns
GET /app/v2/gameratingsAverage rating for every rated game
GET /app/v2/gamerating/{gameID}One game's rating and reviews
GET /app/v1/gameviewsView counts per game
GET /stats/downloadsDownload counts per game
GET /average-app-ratingAscendara's average rating

File Hosts

EndpointReturns
GET /app/json/providersURL patterns for each supported file host
GET /app/json/torboxstatusOnline/offline status of each file host

Releases and Content

EndpointReturns
GET /json/changelog/v2Changelog
GET /json/newsNews posts
GET /json/roadmapRoadmap
GET /app/earlychanges/readExperimental features and votes
GET /json/publicthemesCommunity themes
GET /virustotal/latestLatest VirusTotal scans
GET /language/versionLanguage file version
GET /language/enEnglish language file
POST /site/feedbackSubmits feedback