API Docs

» calendar/premieres

Summary

Returns all shows premiering during the time period specified.

URL

http://api.trakt.tv/calendar/premieres.format/apikey/date/days

Supported formats

json

Supported request methods

GET

Requires authentication

optional (details)

If you send valid auth, each show will contain the rating (love or hate, false if not rated), rating_advanced (1-10, 0 if not rated), and in_watchlist (boolean). Each episode will contain watched (boolean), plays (int), in_watchlist (boolean), in_collection (boolean), rating (love or hate, false if not rated), and rating_advanced (1-10, 0 if not rated).

Required Parameters

  • apikey

    to view your API key.

  • date (optional)

    Start date for the calendar in the format Ymd (i.e. 20110421). If blank, defaults to today.

  • days (optional)

    Number of days to display starting from the date. If blank, defaults to 7 days.

Example Request

http://api.trakt.tv/calendar/premieres.json/apikey

[
   {
      "date":"2013-09-15",
      "episodes":[
         {
            "show":{
               "title":"Bones",
               "year":2005,
               "url":"http://trakt.tv/show/bones",
               "first_aired":1126666800,
               "first_aired_iso":"2005-09-13T20:00:00-05:00",
               "first_aired_localized":1126666800,
               "first_aired_utc":1126684800,
               "country":"United States",
               "overview":"F.B.I. Agent Seeley Booth is teamed up with forensic anthropologist Dr. Temperance Bones Brennan to solve some of the most baffling and bizarre crimes ever. Booth depends on clues from the living, witnesses and suspects, while Brennan gathers evidence from the dead, relying on her uncanny ability to read clues left behind in the bones of the victims.",
               "runtime":60,
               "network":"FOX",
               "air_day_localized":"Tuesday",
               "air_day_utc":"Wednesday",
               "air_time":"8:00pm",
               "air_time_localized":"8:00pm",
               "air_time_utc":"1:00am",
               "certification":"TV-14",
               "imdb_id":"tt0460627",
               "tvdb_id":"75682",
               "tvrage_id":"2870",
               "images":{
                  "poster":"http://slurm.trakt.us/images/posters/92.8.jpg",
                  "fanart":"http://slurm.trakt.us/images/fanart/92.8.jpg",
                  "banner":"http://slurm.trakt.us/images/banners/92.8.jpg"
               },
               "ratings":{
                  "percentage":84,
                  "votes":3010,
                  "loved":2775,
                  "hated":235
               },
               "genres":[
                  "Drama"
               ],
               "rating":false,
               "rating_advanced":0,
               "in_watchlist":false
            },
            "episode":{
               "season":9,
               "number":1,
               "title":"The Secrets in the Proposal",
               "overview":"The Jeffersonian team investigates the murder of Jason Siedel, an accountant for the state department, whose remains were found in a hotel air conditioning unit. When Booth finds his old army buddy and CIA agent, Danny Beck, clearing away evidence at the victim's condo, he begins to realize that Siedel's murder could yield more suspects than the team had anticipated. Booth also seeks out Aldo Clemens, his friend and an ex-priest from their military days together, to get advice on his relationship with Brennan, now that Pelant has put a wedge between them. Meanwhile, Brennan must decide whether to have faith in Booth or to end her relationship with him.",
               "url":"http://trakt.tv/show/bones/season/9/episode/1",
               "first_aired":1379386800,
               "first_aired_iso":"2013-09-16T20:00:00-05:00",
               "first_aired_localized":1379386800,
               "first_aired_utc":1379404800,
               "images":{
                  "screen":"http://slurm.trakt.us/images/fanart/92-940.8.jpg"
               },
               "ratings":{
                  "percentage":95,
                  "votes":8,
                  "loved":8,
                  "hated":0
               },
               "rating":false,
               "rating_advanced":0,
               "in_watchlist":false,
               "plays":0,
               "watched":false,
               "in_collection":false
            }
         }
      ]
   }
]
loading...
Join trakt

Sign in to trakt

forgot?

Sign In
Forgot your password?
Check your email for further instructions!
We couldn't find that e-mail!

Create your new password