Skip to main content

​
Single-title ratings — use the detail endpoint

Per-title ratings (Simkl community average + votes, IMDb rating, MAL rating + rank) are returned as part of the catalog detail endpoints. There’s no separate read-only “ratings by ID” endpoint — the same data lives inside the ratings field of every detail response. The ratings block on every detail response looks like:
Each provider key is present only when Simkl has data on file. Live-action titles typically carry simkl + imdb; modern anime carry simkl + mal; classic anime sometimes carry all three.

​
Bulk ratings for a user’s watchlist

If you need the Simkl community rating + drop rate for every title in the user’s watchlist (one type at a time), use:

GET /ratings/{type}

?user_watchlist=watching (or plantowatch, hold, completed, dropped, comma-separated, or 1 for all). Returns an array of {id, simkl: {rating, votes, droprate}} for every item in those watchlist buckets. Requires a Bearer token. Useful for “decide what to watch next from my plantowatch list” UIs.
For the user’s own ratings (the 1-10 scores they’ve personally assigned), use the Sync endpoints under /sync/ratings.

​
Aggregate ratings on simkl.com

Public catalog pages on simkl.com (e.g. /movies/472214/inception) render the same ratings block plus the user’s reactions and reviews. If your app wants to deep-link rather than render, see the Deep-linking guide.