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

# About Users

> Read public user data, fetch recently-watched art, and update user settings.

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

| Endpoint                                           | What 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}/stats`                      | Returns aggregate watch statistics for the user.                                                                                                            |
| `POST /users/settings`                             | Update the authenticated user's settings.                                                                                                                   |

<Note>
  Cache images on the device using the image URL as the cache key. Image URLs are immutable — never re-download the same URL.
</Note>

<CardGroup cols={2}>
  <Card title="Recently-watched art" icon="image" href="/api-reference/simkl/get-recently-watched-image">
    `GET /users/recently-watched-background/{user_id}`
  </Card>

  <Card title="User stats" icon="chart-simple" href="/api-reference/simkl/get-user-stats">
    `POST /users/{user_id}/stats`
  </Card>

  <Card title="Update settings" icon="gear" href="/api-reference/simkl/get-user-settings">
    `POST /users/settings`
  </Card>
</CardGroup>
