Users In This Discussion

Categories

Keyboard Shortcuts

The Movie Database Support

Support → API Support

r

Add MPAA rating to movies response

posted by ridhwaans
STAFFMOD
on August 17, 2019 at 7:31 PM

Currently the /movies responses have only an adult on/off field, there is no information on the mpaa rating, such as G, pg-13 etc. It would be nice to have it in the api

6 replies (on page 1 of 1)

• Jump to last post

Travis Bell

Reply by  Travis Bell

STAFFMOD

on August 20, 2019 at 12:30 PM

Hi @ridhwaans,

I don't have any immediate plans for this but I did just create a new ticket to think about this in the future.

Thanks.

Benoît Courtine

Reply by  Benoît Courtine

STAFFMOD

on August 21, 2019 at 4:05 AM

Hi @ridhwaans,

You can get this information using append_to=release_dates in your query. You will get the movie certification (pg-13 for example), country by country.

Travis Bell

Reply by  Travis Bell

STAFFMOD

on August 22, 2019 at 11:08 AM

Ya, @bcourtine is correct if you're querying the get details methods. I assumed you were asking about search/discover/lists. If you are hitting the main detail methods, you can get the MPAA info from the /release_dates method.

r

Reply by  ridhwaans

STAFFMOD

on August 26, 2019 at 7:31 PM

thanks @bcourtine and @travisbell one more question:

https://api.themoviedb.org/3/movie/353081?append_to_response=release_dates&language=en-US&region=US&api_key=<<key>>

Above is the api call /movies by id, but the region parameter isnt filtering appended release_dates to US only, instead it is returning dates for every iso_3166_1 region (NL,SK, AU etc)

Thanks in advance

response:

{
...
"release_dates": {
  "results": [
    {
      "iso_3166_1": "CH",
      "release_dates": [
        {
          "certification": "",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-01T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "NL",
      "release_dates": [
        {
          "certification": "12",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-02T00:00:00.000Z",
          "type": 3
        },
        {
          "certification": "12",
          "iso_639_1": "",
          "note": "DVD, Blu ray",
          "release_date": "2018-12-05T00:00:00.000Z",
          "type": 5
        }
      ]
    },
    {
      "iso_3166_1": "SK",
      "release_dates": [
        {
          "certification": "12",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-02T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "HK",
      "release_dates": [
        {
          "certification": "IIA",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-07-26T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "AU",
      "release_dates": [
        {
          "certification": "M",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-02T00:00:00.000Z",
          "type": 3
        },
        {
          "certification": "M",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-11-28T00:00:00.000Z",
          "type": 5
        }
      ]
    },
    {
      "iso_3166_1": "LT",
      "release_dates": [
        {
          "certification": "",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-17T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "IN",
      "release_dates": [
        {
          "certification": "",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-07-27T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "DK",
      "release_dates": [
        {
          "certification": "11",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-07-26T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "KR",
      "release_dates": [
        {
          "certification": "15세 이상 관람가",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-07-25T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "GR",
      "release_dates": [
        {
          "certification": "",
          "iso_639_1": "en",
          "note": "",
          "release_date": "2018-08-30T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "CN",
      "release_dates": [
        {
          "certification": "",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-31T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "ES",
      "release_dates": [
        {
          "certification": "12",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-07-27T00:00:00.000Z",
          "type": 3
        },
        {
          "certification": "",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-11-21T00:00:00.000Z",
          "type": 5
        }
      ]
    },
    {
      "iso_3166_1": "TR",
      "release_dates": [
        {
          "certification": "",
          "iso_639_1": "",
          "release_date": "2018-07-27T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "IT",
      "release_dates": [
        {
          "certification": "T",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-30T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "IL",
      "release_dates": [
        {
          "certification": "הותר לכל",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-07-26T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "HU",
      "release_dates": [
        {
          "certification": "16",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-02T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "BR",
      "release_dates": [
        {
          "certification": "14",
          "iso_639_1": "pt",
          "note": "",
          "release_date": "2018-07-26T00:00:00.000Z",
          "type": 3
        },
        {
          "certification": "14",
          "iso_639_1": "pt",
          "note": "",
          "release_date": "2018-11-07T00:00:00.000Z",
          "type": 4
        }
      ]
    },
    {
      "iso_3166_1": "DE",
      "release_dates": [
        {
          "certification": "12",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-02T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "GB",
      "release_dates": [
        {
          "certification": "",
          "iso_639_1": "",
          "note": "London",
          "release_date": "2018-07-13T00:00:00.000Z",
          "type": 2
        },
        {
          "certification": "12A",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-07-25T00:00:00.000Z",
          "type": 3
        },
        {
          "certification": "12A",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-12-03T00:00:00.000Z",
          "type": 4
        },
        {
          "certification": "12A",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-12-03T00:00:00.000Z",
          "type": 5
        }
      ]
    },
    {
      "iso_3166_1": "UA",
      "release_dates": [
        {
          "certification": "",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-07-26T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "PT",
      "release_dates": [
        {
          "certification": "M/12",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-02T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "US",
      "release_dates": [
        {
          "certification": "PG-13",
          "iso_639_1": "en",
          "note": "",
          "release_date": "2018-07-27T00:00:00.000Z",
          "type": 3
        },
        {
          "certification": "PG-13",
          "iso_639_1": "en",
          "note": "",
          "release_date": "2018-11-20T00:00:00.000Z",
          "type": 4
        },
        {
          "certification": "PG-13",
          "iso_639_1": "en",
          "note": "",
          "release_date": "2018-12-04T00:00:00.000Z",
          "type": 5
        }
      ]
    },
    {
      "iso_3166_1": "FR",
      "release_dates": [
        {
          "certification": "",
          "iso_639_1": "",
          "note": "Paris",
          "release_date": "2018-07-12T00:00:00.000Z",
          "type": 1
        },
        {
          "certification": "U",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-01T00:00:00.000Z",
          "type": 3
        },
        {
          "certification": "U",
          "iso_639_1": "fr",
          "note": "",
          "release_date": "2018-12-05T00:00:00.000Z",
          "type": 5
        }
      ]
    },
    {
      "iso_3166_1": "SE",
      "release_dates": [
        {
          "certification": "15",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-03T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "JP",
      "release_dates": [
        {
          "certification": "G",
          "iso_639_1": "",
          "note": "",
          "release_date": "2018-08-03T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "RU",
      "release_dates": [
        {
          "certification": "16+",
          "iso_639_1": "ru",
          "note": "",
          "release_date": "2018-07-26T00:00:00.000Z",
          "type": 1
        }
      ]
    }
  ]
}
...
}
Travis Bell

Reply by  Travis Bell

STAFFMOD

on August 27, 2019 at 2:02 PM

The region param has no effect on the /release_dates query and does not filter release dates at this time. You will have to filter them client side.

s

Reply by  sergioq

STAFFMOD

on April 15, 2020 at 5:00 AM

I am having the same problem, trying to get the MPAA rating. So upon finding this I executed 

https://api.themoviedb.org/3/movie/388202?api_key=<<my key>>&append_to_response=release_dates

And looking over the results in the browser, I see nothing that looks like an MPAA rating.

{"adult":false,"backdrop_path":"/vpITvdKDZkxS799DK1I9MAVCN2v.jpg","belongs_to_collection":null,"budget":10000000,"genres":[{"id":28,"name":"Action"},{"id":80,"name":"Crime"},{"id":53,"name":"Thriller"}],"homepage":"","id":388202,"imdb_id":"tt5580536","original_language":"en","original_title":"Arsenal","overview":"After the deadbeat brother of a businessman is assumed to be in on his own kidnapping, his sibling must take action to rescue him.","popularity":9.326,"poster_path":"/b9vwgGqWge0PRZqhbqOW7WCVK2V.jpg","production_companies":[{"id":290,"logo_path":"/Q8mw2AOQQc8Qg0uNwLWq86DVZv.png","name":"Ingenious Media","origin_country":"GB"},{"id":73685,"logo_path":null,"name":"Emmett Furla Oasis Films","origin_country":"US"},{"id":76991,"logo_path":"/pQjdvbv4y9yuIDSHDEHc9ijJKaS.png","name":"Highland Film Group","origin_country":"US"},{"id":85562,"logo_path":null,"name":"River Bay Films","origin_country":""},{"id":85563,"logo_path":null,"name":"Tinker Productions","origin_country":""},{"id":1632,"logo_path":"/cisLn1YAUuptXVBa0xjq7ST9cH0.png","name":"Lionsgate","origin_country":"US"},{"id":36109,"logo_path":"/wca0Jcidf2N1KAPicYMjGoKOmYu.png","name":"The Fyzz","origin_country":"GB"}],"production_countries":[{"iso_3166_1":"US","name":"United States of America"}],"release_date":"2017-01-06","revenue":0,"runtime":92,"spoken_languages":[{"iso_639_1":"en","name":"English"}],"status":"Released","tagline":"Brotherhood has its price.","title":"Arsenal","video":false,"vote_average":4.6,"vote_count":80,"release_dates":{"results":[{"iso_3166_1":"GB","release_dates":[{"certification":"18","iso_639_1":"en","note":"DVD","release_date":"2017-04-17T00:00:00.000Z","type":5}]},{"iso_3166_1":"DE","release_dates":[{"certification":"18","iso_639_1":"de","release_date":"2017-11-05T00:00:00.000Z","type":4}]},{"iso_3166_1":"FR","release_dates":[{"certification":"","iso_639_1":"","note":"Netflix","release_date":"2017-06-14T00:00:00.000Z","type":4}]},{"iso_3166_1":"US","release_dates":[{"certification":"","iso_639_1":"en","release_date":"2017-01-06T00:00:00.000Z","type":3}]}]}}

Can't find a movie or TV show? Login to create it.

Login

Sign Up

Global

s focus the search bar
p open profile menu
esc close an open window
? open keyboard shortcut window

On media pages

b go back (or to parent when applicable)
e go to edit page

On TV season pages

→ (right arrow) go to next season
← (left arrow) go to previous season

On TV episode pages

→ (right arrow) go to next episode
← (left arrow) go to previous episode

On all image pages

a open add image window

On all edit pages

t open translation selector
ctrl+ s submit form

On discussion pages

n create new discussion
w toggle watching status
p toggle public/private
c toggle close/open
a open activity
r reply to discussion
l go to last reply
ctrl+ enter submit your message
→ (right arrow) next page
← (left arrow) previous page

Settings

Want to rate or add this item to a list?

Login

Not a member?

Sign up and join the community