Skip to main content
GET
/
v1
/
images
/
{domain}
/
{entity_type}
/
{entity_id}
/
{size}
Get image by entity
curl --request GET \
  --url https://api.rewind.rest/v1/images/{domain}/{entity_type}/{entity_id}/{size} \
  --header 'Authorization: Bearer <token>'
{
  "error": "Not found",
  "status": 404
}

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,
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.