Skip to main content
GET
Get image by entity

Authorizations

Authorization
string
header
required

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

Path Parameters

domain
enum<string>
required
Available options:
listening,
watching,
collecting,
reading
Example:

"listening"

entity_type
enum<string>
required
Available options:
albums,
artists,
movies,
shows,
releases,
articles
Example:

"albums"

entity_id
string
required
Minimum string length: 1
Example:

"album-123"

size
enum<string>
required
Available options:
thumbnail,
small,
medium,
poster-sm,
large,
poster,
poster-lg,
backdrop,
original
Example:

"medium"

Query Parameters

artist_name
string
Example:

"Radiohead"

album_name
string
Example:

"OK Computer"

mbid
string
Example:

"a1b2c3d4-..."

tmdb_id
string
Example:

"12345"

Response

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