Get ratings
Your ratings from 1 to 10 for movies, shows, seasons and episodes.
GET https://cotlet.dev/api/v1/trakt/ratings
read
Returns the titles you rated with your score and the date you rated them. Filter by type or by a score to find, for example, everything you gave a 10. Use it to match the tone of earlier scores before proposing new ones.
Parameters
| Name | Type | Description |
|---|---|---|
| type string | string | Only this kind of title: 'movies', 'shows', 'seasons' or 'episodes'. Default: all. |
| rating integer | integer | Only titles with this score, 1 to 10. |
| page integer | integer | Page number, starting at 1. Default: 1. |
| limit integer | integer | Items per page. Default: 20. |
Request
curl https://cotlet.dev/api/v1/trakt/ratings \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("trakt", "get_ratings")const result = await cotlet.call('trakt', 'get_ratings');cotlet call trakt get_ratingsExample response
{
"items": [
{
"type": "movie",
"title": "Past Lives",
"year": 2023,
"rating": 9,
"rated_at": "2026-09-30T22:10:00Z"
},
{
"type": "show",
"title": "Slow Horses",
"year": 2022,
"rating": 8,
"rated_at": "2026-08-14T20:00:00Z"
}
],
"page": 1,
"total_pages": 6
}