Gary & Goober API Documentation

A RESTful API providing random images, quotes, and jokes with structured JSON responses

Base URL: https://api.garythe.cat

All endpoints return JSON responses unless otherwise specified. Images include extracted numeric IDs from filenames.

Retrieves a random Gary image URL with its extracted numeric identifier from the filename.

Example Response

{
  "url": "https://api.garythe.cat/Gary/Gary76.jpg",
  "number": 76
}

Returns a random Gary image directly as binary JPEG data for immediate display or download.

Retrieves a random Goober image URL with its extracted numeric identifier from the filename.

Example Response

{
  "url": "https://api.garythe.cat/Goober/goober8.jpg",
  "number": 8
}

Returns a random Goober image directly as binary JPEG data for immediate display or download.

Retrieves a random inspirational quote from the configured quote collection.

Example Response

{
  "quote": "Be yourself; everyone else is already taken."
}

Retrieves a random joke from the collection for entertainment purposes.

Example Response

{
  "joke": "Why don't scientists trust atoms? Because they make up everything!"
}