Community ratings for items in the user's watchlist
This endpoint returns Simkl’s community ratings (the public average + droprate + vote counts) for every item in the user’s watchlist — not the user’s own 1-10 scores. If you want the user’s own ratings, every GET /sync/all-items response already carries user_rating (1-10 or null) per item — filter that client-side. For server-side filtering by score (e.g. “give me only items I rated 9 or 10”), see GET /sync/ratings/:type/:rating.
Bulk Simkl-rating lookup for items across the user’s watchlist. Useful for ranking the user’s library against community ratings (e.g. “what’s the highest-community-rated movie in my Plan-to-Watch?”).
Returns an array of {id, simkl: {rating, votes, droprate}} for every item in the requested watchlist statuses. Pair with GET /movies/{id} / GET /tv/{id} / GET /anime/{id} (Cloudflare-cached) when you need the full record for any individual item.
Path
| Segment | Values | Notes |
|---|---|---|
type | movies, tv, anime, all | Required. Use /ratings/all to get every type in one response. |
Query
| Param | Required | Notes |
|---|---|---|
user_watchlist | yes | Comma-separated list of watchlist statuses to include. Any of watching, plantowatch, hold, completed, dropped. Use 1 (or any non-empty value) as a shorthand for “all statuses”. Without this param the request silently falls through to a different code path and returns 200 null — always supply it. |
fields | no | Comma-separated extra blocks to include alongside the default simkl block. See the Fields values table below. |
Fields values
fields value | Adds |
|---|---|
simkl (default) | simkl: {rating, votes, droprate} per item. |
ext | imdb: {rating, votes} and/or mal: {rating, votes, rank} (only the providers Simkl has on file for the title). |
rank | rank integer — Simkl’s catalog rank for the item. |
release_status | Release status, lower-case: released (movies), ended, returning series (TV) or ongoing (anime). Titles not out yet: upcoming, planned, in production, post production, rumored or canceled. |
year | release_year integer. |
link | Canonical Simkl URL for the item. |
Combine multiple with commas: fields=simkl,ext,year,rank. Unknown values (including reactions and has_trailer, which are valid on the hidden single-item rating endpoint but not here) are silently ignored.
Auth
Requires Authorization: Bearer <access_token> plus the standard client_id / app-name / app-version URL params.
For the user’s own ratings (the 1-10 scores they’ve assigned), use GET /sync/ratings/:type/:rating instead — that’s the user-rated-by-them endpoint, this one is community-rating-of-everything-in-their-list.
Authorizations
Preferred form: your client_id as a URL query parameter on every request. Self-describing in logs and curl commands. See Headers and required parameters.
A user access_token, sent as Authorization: Bearer .... Required for endpoints that read or modify the user's library, scrobble session, ratings, settings, or playbacks. Every flow returns the same kind of token. See Set up authentication.
Headers
Path Parameters
Query Parameters
- A comma-separated list of additional fields to include in the response.
simkl– returns the Simkl rating and votes.ext– includes external ratings such as IMDB or MAL if available.rank– returns the rank within the Simkl service for that media type (movie, tv, anime).release_status– includes the release status of the item.year– includes the year of release.link– includes the title's simkl.com URL.- Example:
fields=rank,simkl,ext,year.droprateis not a field of its own — it comes insidesimkl.
"simkl,ext,year"
Your client_id from your Simkl developer settings. Required on every request.
Response
OK
Lower-case release status. released is movies only; returning series is TV and ongoing anime for titles still airing; ended for finished shows and anime. Titles not out yet: upcoming, planned, in production, post production, rumored, canceled. Only with fields=release_status.
released, ended, returning series, ongoing, upcoming, planned, in production, post production, rumored, canceled Type 4 null — no release year on file. See Null and missing values. Only with fields=year.
Type 4 null — not ranked yet. See Null and missing values. Simkl rank within the media type. Only with fields=rank.