Ascendara API Overview

The Ascendara API is a RESTful interface for game discovery, download tracking, system health, and image assets. It is designed for non-commercial use and does not serve actual game files.

Base URL#

https://api.ascendara.app

Response Format#

All responses are JSON. Success and error response structures depend on the endpoint.

Example Success Responses

Health check:

{
  "status": "healthy",
  "version": "5.5",
  "endpoint": "ascendara-api"
}

Download tracked:

{
  "message": "Download tracked successfully"
}

Version info:

{
  "version": "x.x.x"
}

Example Error Response

{
  "error": "error_message"
}

Rate Limiting#

• Image endpoints: 30 requests per 60 seconds
• General endpoints: 3 requests per hour
• Rate limits are per IP
• Some endpoints have custom limits (see endpoint reference)

Health & Status#

• GET /health — Returns API health and version
• GET / — Returns running version and status

Game Data#

• GET /json/games — List all games with metadata
• GET /v2/image/{imageid} — Get image for a specific game
• GET /v2/image?place={position} — Get game image by popularity weight

Statistics#

• GET /stats/downloads — Download counts for all games
• POST /stats/download — Track a download event

Information#

• GET /json/changelog — Changelog information
• GET /public/json/current — Current data version
• GET /json/roadmap — Roadmap information

Language#

• GET /language/version — Current language file version
• GET /language/en — English translation file

Other#

• GET /virustotal/latest — Latest VirusTotal results
• GET /average-app-rating — App average rating
• GET /opencritic/game?name={game} — OpenCritic info for a game
• POST /site/feedback — Submit feedback (rate limited)

Error Handling#

All endpoints return errors in the format:

{
  "error": "error_message"
}

Common HTTP status codes:

• 200: Success
• 400: Bad Request
• 404: Not Found
• 429: Rate Limit Exceeded
• 500: Server Error