Add Ratings

This endpoint allows you to rate a TV episode and save it to your rated list.

Important Note

If the TV episode you rated is on your watchlist, it will be automatically removed. This keeps your “watched” and “want to watch” lists tidy and in sync. You can edit this behavior here.

POST /3/tv/{series_id}/season/{season_number}/episode/{episode_number}/rating

Try it

Add Ratings

cURL

curl --request POST \
  --url 'https://api.themoviedb.org/3/tv/{{series_id}}/season/{{season_number}}/episode/{{episode_number}}/rating' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "media_id": 93405,
  "media_type": "tv",
  "value": 8.5
}
'

201

{
  "status_code": 1,
  "status_message": "Success.",
  "success": true
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

series_id · string · required

This represents the series ID. Get it here

season_number · string · required

This represents the season number of the TV show.

episode_number · string · required

This represents the episode number of the TV show.

Body

application/json

media_id · number

This represents the media ID. Get it here

Example:

93405

media_type · string

This represents the media type.

Example:

"tv"

value · number

This represents your rating score.

Example:

8.5

Response

201 - application/json

Add Ratings

status_code · number

Example:

1

status_message · string

Example:

"Success."

success · boolean

Example:

true