Last.fm Collage Generator API v2.2
=================================

Discover options
----------------
GET https://lastfm.riffology.co/api/options

This returns every supported format, dimension, theme, layout, content type, period, and label mode. Build clients from this
response instead of hard-coding selector values.

Generate a collage
------------------
GET https://lastfm.riffology.co/api

Parameters
----------
username      Required. Existing Last.fm username.
layout        collage or grid. Default: collage.
type          album or artist. Default: album.
time          7day, 1month, 3month, 6month, 12month, overall, specific_week.
columns       Grid columns from 2 to 10. Default: 5.
labels        none, top5, all (labels=none|top5|all). yes/no remain aliases.
format        square, instagram_portrait, social_feed, story, pinterest, landscape, classic.
theme         paper, ink, sage, blush, cobalt, sunset, midnight, carbon, archive, aluminium, lilac, gig.
              Default: paper. Text never overlaps the artwork.
spacing       black, white, clear. Default: black. Colour of the gaps between
              tiles; clear makes them transparent (format=classic returns a PNG).
background    Deprecated: old background IDs still work and map to a theme.
typography    Deprecated: accepted and ignored (each theme sets its own type).
title         Optional custom title, up to 100 characters.
show_title    Boolean. Default: true.
show_details  Boolean. Default: true where the format supports a summary.
from / to     Unix timestamps required when time=specific_week.

Invalid selector values return HTTP 400 with a JSON error and accepted values.

Story example
-------------
https://lastfm.riffology.co/api?username=rj&layout=collage&type=album&time=1month&labels=top5&format=story&theme=midnight&show_details=true

Social Feed example
-------------------
https://lastfm.riffology.co/api?username=rj&layout=grid&columns=5&type=album&time=7day&labels=top5&format=social_feed&theme=carbon&title=My%20Listening%20Week

Specific week example
---------------------
https://lastfm.riffology.co/api?username=rj&time=specific_week&from=1785715200&to=1786320000&layout=collage&type=artist&labels=top5&format=story&theme=archive

Output formats
--------------
square               1500 x 1500  Instagram, Facebook, Threads
instagram_portrait   1080 x 1440  Instagram feed
social_feed          1080 x 1350  Instagram and Facebook feeds
story                1080 x 1920  Instagram/Facebook Stories, TikTok
pinterest            1000 x 1500  Pinterest Pins
landscape            1200 x 628   LinkedIn and X
classic              1500 x 1500  Plain artwork square, no background/title/footer

Notes
-----
- One-shot API requests do not pause for missing-art uploads.
- Generation time depends on Last.fm response time and artwork cache coverage.
- The response is image/jpeg with a format-aware filename, or image/png for
  format=classic&spacing=clear.
- Public generated-image URLs are temporary. Download or share the returned
  JPEG rather than treating the job URL as permanent storage.