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 Gully image URL with its extracted numeric identifier from the filename.

Example Response

{
    "url": "https://api.garythe.cat/Gully/gully1.jpg",
    "number": 1
  }

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

Returns the current number of images available for each collection. Useful for monitoring or UI counters.

Example Responses

{ "count": 42 }

{ "count": 8 }

{ "count": 10 }

Retrieves a random joke from the collection for entertainment purposes.

Example Response

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