2.1 Deprecation Notice!

Please be aware that the 2.1 version of our API has been deprecated. 2.1 will be shut down on September 15, 2013. It has been replaced by v3. You can read the new API documentation here.

Genres.getList

The Genres.getList method is used to retrieve a list of valid genres within TMDb. You can also request the translated values by passing the language option.

Example URL

http://api.themoviedb.org/2.1/Genres.getList/en/xml/APIKEY

Options

Language: IETF Language Tag, e.g. en-US

Type: Type can be xml, yaml or json.

API Key: The API key we supplied you with for your account.

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">
  <opensearch:Query searchTerms=""/>
  <opensearch:totalResults>24</opensearch:totalResults>
  <genres>
    <translated>true</translated>
    <genre name="Action">
      <id>28</id>
      <url>http://www.themoviedb.org/genre/action</url>
    </genre>
    <genre name="Adventure">
      <id>12</id>
      <url>http://www.themoviedb.org/genre/adventure</url>
    </genre>
    <genre name="Animation">
      <id>16</id>
      <url>http://www.themoviedb.org/genre/animation</url>
    </genre>
    <genre name="Comedy">
      <id>35</id>
      <url>http://www.themoviedb.org/genre/comedy</url>
    </genre>
    <genre name="Crime">
      <id>80</id>
      <url>http://www.themoviedb.org/genre/crime</url>
    </genre>
    <genre name="Disaster">
      <id>105</id>
      <url>http://www.themoviedb.org/genre/disaster</url>
    </genre>
    <genre name="Documentary">
      <id>99</id>
      <url>http://www.themoviedb.org/genre/documentary</url>
    </genre>
    <genre name="Drama">
      <id>18</id>
      <url>http://www.themoviedb.org/genre/drama</url>
    </genre>
    <genre name="Eastern">
      <id>82</id>
      <url>http://www.themoviedb.org/genre/eastern</url>
    </genre>
    <genre name="Fantasy">
      <id>14</id>
      <url>http://www.themoviedb.org/genre/fantasy</url>
    </genre>
    <genre name="History">
      <id>36</id>
      <url>http://www.themoviedb.org/genre/history</url>
    </genre>
    <genre name="Holiday">
      <id>10595</id>
      <url>http://www.themoviedb.org/genre/holiday</url>
    </genre>
    <genre name="Horror">
      <id>27</id>
      <url>http://www.themoviedb.org/genre/horror</url>
    </genre>
    <genre name="Music">
      <id>10402</id>
      <url>http://www.themoviedb.org/genre/music</url>
    </genre>
    <genre name="Musical">
      <id>22</id>
      <url>http://www.themoviedb.org/genre/musical</url>
    </genre>
    <genre name="Mystery">
      <id>9648</id>
      <url>http://www.themoviedb.org/genre/mystery</url>
    </genre>
    <genre name="Road Movie">
      <id>1115</id>
      <url>http://www.themoviedb.org/genre/road-movie</url>
    </genre>
    <genre name="Science Fiction">
      <id>878</id>
      <url>http://www.themoviedb.org/genre/science-fiction</url>
    </genre>
    <genre name="Short">
      <id>10749</id>
      <url>http://www.themoviedb.org/genre/short</url>
    </genre>
    <genre name="Sport">
      <id>9805</id>
      <url>http://www.themoviedb.org/genre/sport</url>
    </genre>
    <genre name="Suspense">
      <id>10748</id>
      <url>http://www.themoviedb.org/genre/suspense</url>
    </genre>
    <genre name="Thriller">
      <id>53</id>
      <url>http://www.themoviedb.org/genre/thriller</url>
    </genre>
    <genre name="Western">
      <id>37</id>
      <url>http://www.themoviedb.org/genre/western</url>
    </genre>
  </genres>
</OpenSearchDescription>