Total Albums
--
Total Images
--
Total Pages (20/page)
--
Last Updated
--
GET /api/v1/albums max 20/page

Get all albums with pagination. Returns album list with cover image and total images.

Parameter Type Default Description
page integer 1 Page number
limit integer 20 Items per page (max 20)
min_images integer 0 Minimum images per album to include
Try it now
Full URL https://my.erohere.eu/api/v1/albums?page=1&limit=20&min_images=0
Loading...
Click "Execute" to test this endpoint
GET /api/v1/random max 20/page

Get random albums with pagination. Perfect for discovery mode.

Parameter Type Default Description
page integer 1 Page number
limit integer 20 Items per page (max 20)
min_images integer 0 Minimum images per album to include
Try it now
Full URL https://my.erohere.eu/api/v1/random?page=1&limit=20&min_images=0
Loading...
Click "Execute" to test this endpoint
GET /api/v1/search max 20/page

Search albums by name. Supports fuzzy search and multiple languages.

Parameter Type Default Description
q string - Search query (required)
page integer 1 Page number
limit integer 20 Items per page (max 20)
min_images integer 0 Minimum images per album to include
Try it now
Full URL https://my.erohere.eu/api/v1/search?q=Momiko&page=1&limit=20&min_images=0
Loading...
Click "Execute" to test this endpoint
GET /api/v1/album/{slug} max 20/page

Get images from a specific album using its slug. Returns image URLs and file sizes.

Parameter Type Default Description
slug string - Album slug (required)
page integer 1 Page number
limit integer 20 Items per page (max 20)
Try it now
Full URL https://my.erohere.eu/api/v1/album/c107-enako-ikora?page=1&limit=20
Loading...
Click "Execute" to test this endpoint
GET /api/v1/stats no params

Get total statistics including album count, image count, and last update time.

Try it now
Full URL https://my.erohere.eu/api/v1/stats
Loading...
Click "Execute" to test this endpoint

Changelog

v1.2.1 Latest November 1, 2026
  • Fixed - Album covers now always resolve correctly (no more null covers)
  • Fixed - total_images no longer returns 0 for albums that actually contain images
  • Fixed - Random endpoint occasionally returned albums without cover
  • Improved - Cover & image count now fall back to filesystem scan when cache is empty
  • Improved - Consistent cover resolution across /albums, /random, /search, and /album/{slug}
Cover & image count reliability fix!
v1.2.0 Previous September 2, 2026
  • Added - Performance optimization for faster API responses
  • Added - min_images filter parameter for albums endpoint
  • Improved - Album search now faster with optimized query handling
  • Improved - Response time reduced from 5-10 seconds to under 200ms
  • Fixed - Album slug resolution now works correctly
  • Fixed - count() error when data returns false
Major performance upgrade!
v1.1.0 Previous August 28, 2026
  • Added - Search endpoint with fuzzy matching
  • Added - Random album endpoint for discovery
  • Improved - Pagination now supports up to 20 items per page
  • Fixed - URL encoding issues with special characters in album names
v1.0.0 Initial August 15, 2026
  • Added - Initial API release
  • Added - Albums list endpoint with pagination
  • Added - Album detail endpoint with images
  • Added - Stats endpoint for gallery statistics
  • Added - CORS support for cross-origin requests

Frequently Asked Questions

Why doesn't this site have categories for albums?
Before we rebranded, we actually used categories for organizing albums. However, we had serious issues with our hosting provider and they did not provide any backup of our album data. Since we couldn't recover all the albums with their categories intact, we made the decision to drop the category system entirely. And honestly... I've just gotten lazy to re-implement it since then.
Why did you create this site?
To be completely honest, this started as just a side project. I was experimenting with something and somehow it grew on me. Over time, I found myself not wanting to abandon it. It became something I genuinely enjoy maintaining, even though I can't exactly explain why.
Why did you build an API?
Finding free resources online is a pain. You have to search through multiple websites, download things manually one by one, deal with broken links, and waste hours just to get a few albums. I've been there, and it sucks. So I figured why not make it easier for everyone? It's my way of giving back to the community.