ROMARCHIVERetro Gaming ROM Repository
Romarchive API
Public API endpoints for programmatic access.
| Endpoint | Method | Description |
|---|---|---|
| /api/browse?path=...&page=1 | GET | Browse ROMs by platform and directory. Params: path (base64), page, sort. |
| /api/search?q=...&platform=gba | GET | Search ROMs (JSON): word-by-word matching, ranked results, suggestions on empty result. Params: q, platform (folder name or alias, e.g. gba/snes/psx), emu=1, multiplayer=online|lan|splitscreen, genre=shooter|platformer|puzzle (flag params are comma-separated; OR within a filter, AND between filters). |
| /api/uptime | GET | Server uptime, ROM count and platform count (JSON). |
| /api/get_random_ad?size=468x60&lang=en|ru | GET | Random ad as JSON: link, image, alt, size. Required: size (WxH, e.g. 468x60). Optional: lang=en|ru (default: auto-detected from Accept-Language). |
| /api/doom/top | GET | Returns top 5 voted DOOM mods of the day (one per line, plain text). Returns "vanilla" if no votes yet. |
| /api/collections | GET | List authenticated user's collections (JSON). |
| /api/collection/:id | GET | Get collection metadata and games (JSON). |
| /api/blog | GET | List blog posts (JSON). |
| /api/blog/:slug | GET | Get a single blog post by slug (JSON). |
