Redirect to a user's last-watched cover image
Pulls metadata about the user’s most recently watched item — useful for “Now Watching” widgets, dashboard backgrounds, and embedded user-cards.
No access_token needed on AUTH V1 — just your client_id. AUTH V2 apps must send the user’s token — an anonymous call returns 401 user_token_required. See AUTH V2 overview. The target user’s profile must be public; private profiles return 404.
Two response modes (selected by the image query param)
image | Status | Body | Use case |
|---|---|---|---|
| omitted | 200 | JSON with id, url, title, poster, fanart | Server-side render or custom card layout |
poster | 302 | Empty; Location: https://simkl.net/posters/<key>_0.jpg | Drop the request URL straight into <img src=…> |
fanart | 302 | Empty; Location: https://simkl.net/fanart/<key>_0.jpg | Same — full-bleed background image |
Drop-in <img> example
The ?image= redirect modes are designed for <img src="…"> tags. The browser follows the 302 automatically and renders the JPG — no JSON parsing, no string concatenation, no extra requests:
JSON mode shape
The no-param mode returns the same image keys as the redirect modes — concatenate manually if you want to skip the second round-trip:
Render as https://simkl.net/posters/<poster>_0.jpg / https://simkl.net/fanart/<fanart>_0.jpg.
Authorizations
Optional alias for the client_id query parameter. Simkl accepts your client_id either as the simkl-api-key request header or as the ?client_id=… query parameter — pick one. The query-parameter form is preferred because it makes the request fully self-describing in URL form.
Headers
Query Parameters
Switches the response mode:
- Omitted (no
imageparam) →200with JSON metadata (id,url,title,poster,fanart). image=poster→302redirect to the poster JPG onsimkl.net/posters/.image=fanart→302redirect to the fanart JPG onsimkl.net/fanart/.
The two redirect modes are designed to drop straight into an <img src="…"> tag — no JSON parsing or string concatenation needed.
poster, fanart Your client_id from your Simkl developer settings. Required on every request.
Response
Returned when ?image= is omitted. JSON metadata about the user's most recently watched item.
Metadata about the user's most recently watched item. Returned by GET /users/recently-watched-background/{user_id} when called WITHOUT the ?image= query param. The poster and fanart fields are catalog image keys (the on-disk path prefix) — to render the actual JPG, either call the same endpoint again with ?image=poster (or ?image=fanart) to get a 302 redirect to the JPG, or concatenate manually: https://simkl.net/posters/<poster>_0.jpg / https://simkl.net/fanart/<fanart>_0.jpg.
Type 4 null — data not on file in that field's slot. See Null and missing values. When present, the poster image key (e.g. "17/17465abcd") — render as https://simkl.net/posters/<this>_0.jpg.
"17/17465posterkey"
Type 4 null — data not on file in that field's slot. See Null and missing values. When present, the fanart image key — render as https://simkl.net/fanart/<this>_0.jpg.
"17/17465fanartkey"