thetvdb / v4-api

Founded in 2006, TheTVDB is one of the longest-running community-driven TV and Movie databases. With content metadata across hundreds of thousands of TV series and movies, TheTVDB powers many of the largest media centers in the market. Developers across the world build and rely upon TheTVDB's APIs to power their apps, utilities, and projects, generating millions of API calls per day. In our GitHub repository you will find all of the necessary support and v4 API documentation to make use of TheTVDB's metadata. Come and join us!
134 stars 13 forks source link

No contentRatings information available for series, only for episodes #169

Open sgregori opened 2 years ago

sgregori commented 2 years ago

Using the v3 API, i get "USA: TV-14" for example when asking for series, but this information isn't available with the series using v4, only for specific episode.

/series/{id}/extended

No contentRatings information

/episodes/{id}/extended

"contentRatings": [
      {
        "id": 246,
        "name": "TV-14",
        "country": "usa",
        "description": "Not suitable for children under 14",
        "contentType": "",
        "order": 0,
        "fullname": null
      }
    ],

I can't found also the rating score, on v3 api represented as: ( score maybe? )

"rating":{
"thetvdb":8
},
antheaezzell commented 2 years ago

@sgregori let me discuss this with the team as a potential enhancement. You are right that we have lowered content rating down to the episode level for accuracy and that that is what is available on the v4 API. I assume you are looking for a rolled up rating by country at the series level?

sgregori commented 2 years ago

Hi, for me isn't necessary rating by country at series level.

At this moment i used the last episode contentRating as value for serie contentRating.

Its only because i writed a Synology VideoStation plugin that works as replacement for the actual plugin that uses V3 API.

At V3, there are USA contentRating for serie and episode, but at V4 its only available for each episode.

Another question is the number of calls to the api for getting same information, with V4 is higher thant V3, but i writed a file/url cache for lowering number of petitions when reindexing folders.

Thank you very much for your attention.

antheaezzell commented 2 years ago

Thank you for the explanation @sgregori I have ticketed your request for the API enhancement and will let you know when I discuss it with the developers.

Internal ticket for our reference: https://mediamorph.atlassian.net/browse/TVD-2722

sgregori commented 2 years ago

Very happy after reading the latest development newsletter.

Thanks

antheaezzell commented 2 years ago

Yes. This should be released very shortly. Maybe even today.

antheaezzell commented 2 years ago

@sgregori this was released in v4.5.4 let us know if it meets with your expectation.

sgregori commented 2 years ago

Seems nice, but some series that i checked, doesnt have any value at contentRating field. Finally i found one with content rating value as spected:

 "contentRatings": [
      {
        "id": 77,
        "name": "FSK 16",
        "country": "deu",
        "description": "Restricted to ages 16 and older",
        "contentType": "",
        "order": 0,
        "fullname": null
      },
      {
        "id": 176,
        "name": "12",
        "country": "prt",
        "description": "For viewers aged 12 or over; parental guidance required for children under 12",
        "contentType": "",
        "order": 0,
        "fullname": null
      },
      {
        "id": 247,
        "name": "TV-MA",
        "country": "usa",
        "description": "Not suitable for children and teens under 17",
        "contentType": "",
        "order": 0,
        "fullname": null
      }
antheaezzell commented 2 years ago

Do you remember which series you checked? Overall we have a pretty low fill rate for ratings since the feature was only added last year, but I can check the front-end to see if they are populated.

sgregori commented 2 years ago

I checked random series, i didnt remember at this time sorry.

I tried to fill some series information on thetvdb website, but ask me for series that i don't know, and i can't answer about them. Manual series adding will be nice.