Changelog

All notable changes to the Quote Gallery API are documented here. This changelog follows Keep a Changelog conventions.

API v1

v1.3.0 — 2025-07-15

Added

• Playlist endpoints — New /api/v1/playlists and /api/v1/playlists/:id endpoints for browsing and retrieving curated quote collections.
• include_quotes parameter — Available on /api/v1/authors/:id and /api/v1/playlists/:id to embed related quotes directly in the response.
• isCurated field on playlist responses to distinguish officially curated playlists from community-created ones.

v1.2.0 — 2025-06-01

Added

• Author search — The /api/v1/authors endpoint now supports a search query parameter for searching authors by name.
• Category filtering — All list endpoints (/quotes, /authors, /playlists) now support filtering by categories (comma-separated).
• language parameter on /api/v1/quotes/:id to request a specific translation as the primary text.

Changed

• Increased maximum limit parameter from 50 to 100 across all list endpoints.

v1.1.0 — 2025-04-15

Added

• Random quote endpoint — New /api/v1/quotes/random endpoint for fetching a random approved quote with optional language and category filters.
• Author endpoint — New /api/v1/authors and /api/v1/authors/:id endpoints for browsing and retrieving author profiles.
• Categories endpoint — New /api/v1/categories endpoint for retrieving all available categories with quote counts.
• Translations — The /api/v1/quotes/:id response now includes a translations array with all available translations of the quote.
• Rate limit headers — All responses now include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.

Changed

• Quote list responses now include an author object with id and name (previously only authorId was returned).

v1.0.0 — 2025-03-01

Added

• Initial release of the Quote Gallery API v1.
• GET /api/v1/quotes — Paginated list of approved public quotes with language and category filtering.
• GET /api/v1/quotes/:id — Retrieve a single quote by ID.
• API key authentication via X-API-Key header.
• Rate limiting with Free (100 req/hr), Hobby (500 req/hr), and Premium (2,000 req/hr) tiers.
• Pagination support with limit and offset parameters on all list endpoints.
• Bundle discount — 25% off paid API tiers for users with an active Supporter subscription.

Versioning Policy

The Quote Gallery API follows Semantic Versioning principles:

• Patch versions (e.g., v1.0.1) — Bug fixes and non-functional changes. No action required.
• Minor versions (e.g., v1.1.0) — New endpoints, optional fields, or parameters. Fully backward compatible. No action required.
• Major versions (e.g., v2.0.0) — Breaking changes. Released under a new URL prefix (e.g., /api/v2). Previous versions remain available with a deprecation timeline.

Deprecation Policy

When a new major API version is released:

1. The previous version enters a deprecation period of at least 12 months.
2. During the deprecation period, the old version continues to work normally but responses include a Deprecation header.
3. After the deprecation period ends, the old version may return 410 Gone responses.
4. Advance notice is provided via email to all registered API key holders and through this changelog.