RetroImgs

API Documentation

Everything you need to know about using the RetroImgs API.

Endpoints

Random Image

GET https://retroimgs.com/api/random

Returns a random retro game screenshot.

Console Specific

GET https://retroimgs.com/api/console/{console-name}

Returns a random screenshot from a specific console.

Game Specific

GET https://retroimgs.com/api/game/{game-id}

Returns a specific game screenshot.

Query Parameters

All endpoints support the following query parameters:

  • width - Desired width in pixels
  • height - Desired height in pixels
  • fit - Resize mode (cover, contain, fill, inside, outside)
  • format - Output format (jpeg, png, webp)
  • quality - Image quality (1-100)

Example:

GET https://retroimgs.com/api/random?width=800&height=600&format=webp&quality=90

Try It Out

Configuration

Preview

Click "Test API" to load an image
/api/random?width=800&height=600&format=webp&quality=90&fit=cover