Rewind

Images

Get image by entity

GET https://api.rewind.rest/v1/images/{domain}/{entity_type}/{entity_id}/{size}

Serve image via CDN redirect. Triggers the image pipeline on cache miss. Returns a 302 redirect to the CDN URL with metadata in response headers.

Authorization

Authorizationheaderstringrequired

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Path Parameters

domainpathenum (string)required
Allowed valueslisteningwatchingcollectingreading
entity_typepathenum (string)required
Allowed valuesalbumsartistsmoviesshowsreleasesarticles
entity_idpathstringrequired
sizepathenum (string)required
Allowed valuesthumbnailsmallmediumposter-smlargeposterposter-lgbackdroporiginal

Query Parameters

artist_namequerystring
album_namequerystring
mbidquerystring
tmdb_idquerystring

Response

Redirect to CDN image URL. Metadata returned via X-ThumbHash, X-Dominant-Color, X-Accent-Color headers.