# Kavita Scrobbling API

**Canonical:** https://apis.io/apis/kavita/kavita-scrobbling-api/  
**Provider:** Kavita — https://apis.io/providers/kavita/  
**Documentation:** https://wiki.kavitareader.com/

Kavita Scrobbling API is one of 48 APIs that [Kavita](https://apis.io/providers/kavita/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Scrobbling. The published artifact set on APIs.io includes an OpenAPI specification.

The Scrobbling API from Kavita — 19 operation(s) for scrobbling.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/Scrobbling/scrobble-settings` | Returns all scrobble providers for a user. |
| POST | `/api/Scrobbling/update-scrobble-settings` | Updates the scrobble settings for a given provider. |
| POST | `/api/Scrobbling/update-user-scrobble-provider` | Update authentication details for the given provider |
| POST | `/api/Scrobbling/generate-scrobble-events` | Generate scrobble events from history. Should only be ran once per user |
| POST | `/api/Scrobbling/generate-scrobble-events-all` | Generate scrobble events from history for all valid providers |
| GET | `/api/Scrobbling/token-expired` | Checks if the current Scrobbling token for the given Provider has expired for… |
| GET | `/api/Scrobbling/expired-tokens` | Returns all expired tokens for the current user |
| GET | `/api/Scrobbling/scrobble-errors` | Returns all scrobbling errors for the instance |
| POST | `/api/Scrobbling/clear-errors` | Clears the scrobbling errors table |
| POST | `/api/Scrobbling/scrobble-events` | Returns the scrobbling history for the user |
| GET | `/api/Scrobbling/holds` | Returns all scrobble holds for the current user |
| GET | `/api/Scrobbling/has-hold` | If there is an active hold on the series |
| GET | `/api/Scrobbling/library-allows-scrobbling` | Does the library the series is in allow scrobbling? |
| POST | `/api/Scrobbling/add-hold` | Adds a hold against the Series for user's scrobbling |
| DELETE | `/api/Scrobbling/remove-hold` | Remove a hold against the Series for user's scrobbling |
| POST | `/api/Scrobbling/bulk-remove-events` | Delete the given scrobble events if they belong to that user |
| DELETE | `/api/Scrobbling/remove-error/{id}` | Delete api scrobbling remove error by id |
| POST | `/api/Scrobbling/retry-scrobble` | Attempts to retry Scrobble Events for the current authenticated user (or… |
| GET | `/api/Scrobbling/next-scrobble-time` | Returns when Scrobbling upload will next execute |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/kavita/openapi/kavita-scrobbling-api-openapi.yml

## Other Kavita APIs (12)

- [Kavita API](https://apis.io/apis/kavita/kavita-api/)
- [Kavita Account API](https://apis.io/apis/kavita/kavita-account-api/)
- [Kavita Activity API](https://apis.io/apis/kavita/kavita-activity-api/)
- [Kavita Admin API](https://apis.io/apis/kavita/kavita-admin-api/)
- [Kavita Annotation API](https://apis.io/apis/kavita/kavita-annotation-api/)
- [Kavita Book API](https://apis.io/apis/kavita/kavita-book-api/)
- [Kavita Cbl API](https://apis.io/apis/kavita/kavita-cbl-api/)
- [Kavita Chapter API](https://apis.io/apis/kavita/kavita-chapter-api/)
- [Kavita Collection API](https://apis.io/apis/kavita/kavita-collection-api/)
- [Kavita Color Scape API](https://apis.io/apis/kavita/kavita-colorscape-api/)
- [Kavita Device API](https://apis.io/apis/kavita/kavita-device-api/)
- [Kavita Download API](https://apis.io/apis/kavita/kavita-download-api/)

## Tags

Scrobbling

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/kavita/kavita-scrobbling-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/kavita/.