August 24, 2015

UPDATES

• /people/:id returns fanart featuring this person.
• /sync/history and /users/:username/history return HTTP headers with how many pages and items are in the results.

X-Pagination-Page-Count: 10
X-Pagination-Item-Count: 100

BUGS

• /users/:username/lists/:id/items correctly returns based on the extended parameter.
• User lists correctly updated the updated_at timestamp after re-ordering the items on the website.

August 18, 2015

UPDATES

• /sync/history and /sync/collection accept a special string released for the watched_at and collected_at dates. This automatically uses the initial release date for the episode or movie.

August 5, 2015

UPDATES

• New methods added to help with TV show and movie discovery. Each method defaults to weekly data, but you can also specify monthly and all time periods. Each result contains stats relative to the time period too.
  /movies/played
  /movies/watched
  /movies/collected
  /shows/played
  /shows/watched
  /shows/collected

July 24, 2015

UPDATES

• /users/likes/lists returns a user object with the response.
• /users/:username/history updated so the filter type is optional. Each item in the response has new id and type values. You can also optionally filter the history results by a specific id and type to only get the history for that specific item.
• /sync/history added as a clone of /users/:username/history but specific for the OAuth similar to the other sync methods.
• /sync/watchlist and /users/:username/watchlist now work without the type filter if you want a full list of everything.
• /sync/history/remove supports removing individual watched history events by passing an array of ids as returned by /sync/history.

BUGS

• TV show banner images will fallback to TVDB if Fanart.tv doesn’t have one yet.

June 26, 2015

BUGS

• Calendar methods were adding 1 additional day of episodes in some cases.
• Fixed 500 error on /users/:username/watchlist for some users.

June 18, 2015

UPDATES

• Show progress methods /shows/progress/watched and /shows/progress/collection will hide seasons by default if the user has hidden them on the website. An optional hidden flag can be set to still return the data.

BUGS

• Liking lists had a bug preventing it from saving for a small subset of users.

June 15, 2015

UPDATES

• New /users/likes method to get all comments and lists a user has liked. You can optionally filter for a specific type.
• Update the progress methods to be in line with how the website calculates progress.
• Show progress methods /shows/progress/watched and /shows/progress/collection can optionally include special episodes now.
• /users/:username/comments and /users/likes return HTTP headers with how many pages and items are in the results.

X-Pagination-Page-Count: 10
X-Pagination-Item-Count: 100

BUGS

• Fixed 500 error for some users on /sync/playback/episodes.
• Improved username slug matching (substitute . with -).

May 27, 2015

UPDATES

• Improved handling of watchlisted_at timestamps so they are only updated when needed.

BUGS

• Checking in to or scrobbling an episode correctly removes the season from the watchlist if needed.

May 22, 2015

BUGS

• Updated movie, show, season, episode, and person objects to always return null for any blank ID.
• Fixed 500 error occurring for some show collections.

May 14, 2015

UPDATES

• Added vip_ep flag to all base user objects. This indicates the user is an Executive Producer VIP member.

BUGS

• Fixed /shows/:id/seasons/:number for some shows that were not displaying the correct episode info.

May 11, 2015

UPDATES

• New /users/:username/comments method added to get all reviews and shouts a user has posted. You can also filter this by the type of item.

April 24, 2015

UPDATES

• Added user_rating to all comment methods so you can easily see what the user rated the item.
• New /users/hidden method to get hidden items for the calendar, watched progress, collected progress, and recommendations. Useful if you want to filter our hidden items in your app. (g+)

BUGS

• Improved the check for invalid API keys.
• Fixed CORS headers for the /oauth endpoints. (g+)

April 22, 2015

UPDATES

• Comments automatically turn into reviews if 200 or more words, no need to figure that out in your app anymore.

April 14, 2015

UPDATES

• Added another caching server to speed up the API more.
• /movies/updates, /shows/updates, and /search return HTTP headers with how many pages and items are in the results. (g+)

X-Pagination-Page-Count: 10
X-Pagination-Item-Count: 100

BUGS

• /movies/:id returns the Last-Modified header. (g+)
• /users/:username/history/episodes correctly applies pagination. (g+)

April 8, 2015

UPDATES

• PIN Authentication added for apps without direct web browser access. This includes media center plugins, command line scripts, and system services. Your app details will have the PIN URL and QR code to get you started. (g+)
• Token (media center) auth is deprecated. Existing apps will continue to work fine, but you should update to PIN Authentication and use that moving forward.
• CORS supported for client side apps. Specify your JavaScript origins in your app settings. (g+)
• /shows/:id/progress/collection includes last_collected_at for the show, and collected_at for each episode.
• /shows/:id/progress/watched includes last_watched_at for the show and each episode.
• Stats methods added for movies, shows, seasons, and episodes.
• Enabled the API Blueprint button on the Trakt.tv API docs so you can learn how to beautifully document your API on Apiary.io.

BUGS

• Fixed 500 error when saving your app details. The error was due to an invalid redirect URI. Make sure to use the full domain + protocol (i.e. https://zapp.com).
• Fixed a bug where brand new (and blank) accounts would incorrectly return episodes when viewing the personal calendar.

March 26, 2015

UPDATES

• New /calendars methods (the old methods are now deprecated and undocumented, but will still work). The new response is a linear list of episodes or movies, starting with the oldest. The all and my results have also been split apart for improved caching and ease of use.
• More backend performance updates to help stabilize the servers.
• Search results weight title matches better so they show up higher in the results.

March 23, 2015

UPDATES

• Improved /sync/history and /sync/collection performance. This should significantly speed up these methods plus have a positive impact on general API performance. (g+)

March 18, 2015

UPDATES

• Canadian shows will use America/Toronto as the baseline time zone. This will improve the accuracy for shows and episodes on the /calendars and /show/:id/summary with full extended info.
• All OAuth pages force SSL.
• Gender specific avatar placeholders. These are still piped through gravatar, but the default image will change if the user has a gender selected.
• Recommendations are still a work in progress, but have been updated to return results based on what’s popular. We’ll continue updating the algorithm to make it better.
• /users/settings returns a account.time_24hr boolean to indicate a preference for a 24 hour time format.
• /shows/:id/seasons can optionally return all episodes. (g+)

BUGS

• Ignore x00 episodes (sometime TVDB syncs these over, but generally they are specials that shouldn’t show up in the normal season).
• Ignore duplicate episodes. This will clean up the season listings and the progress percentages.

March 8, 2015

UPDATES

• App approval is now automatic. When you create (or edit) your app, just agree to the terms listed, save your app, and you’ll be approved. Please also indicate if you plan on using checkin or scrobble functionality. (g+)

BUGS

• /sync/playback correctly filters by episodes or movies.

February 25, 2015

UPDATES

• /search supports year filtering (only applies to movies and shows).
• /sync/playback can be filtered by type and limit.
• Paginated methods will return HTTP headers for reference.

X-Pagination-Page: 1
X-Pagination-Limit: 10

• /movies/trending and /shows/trending return HTTP headers with how many items are being watched and by how many users.

X-Pagination-Item-Count: 543
X-Trending-User-Count: 1721

• comment_count added to /users/:username/lists. (g+)
• Ensure parent_id=0 for top level comments. (g+)
• Get up to 100 items for /movies/:id/related and /shows/:id/related. (g+)
• Ratings distribution added to /users/:username/stats. (g+)
• aired_episodes count added to full season info. (g+)

BUGS

• Formatted UTC date for /shows/popular?extended=full. (g+)
• Adding a single bad item to a custom list. (g+)