Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.simkl.org/llms.txt

Use this file to discover all available pages before exploring further.

Public user data is available via GET methods without an OAuth or PIN token — only a client_id is required. Endpoints that change user data (settings, stats writes) require an authenticated token.
EndpointWhat it does
GET /users/recently-watched-background/{user_id}Returns the user’s most-recently-watched show or movie with its title, large poster, and large fanart. Useful for wallpaper apps or “now watching” widgets.
POST /users/{user_id}/statsReturns aggregate watch statistics for the user.
POST /users/settingsUpdate the authenticated user’s settings.
Cache images on the device using the image URL as the cache key. Image URLs are immutable — never re-download the same URL.

Recently-watched art

GET /users/recently-watched-background/{user_id}

User stats

POST /users/{user_id}/stats

Update settings

POST /users/settings