<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Trakt API Blog - Medium]]></title>
        <description><![CDATA[Everything related to the Trakt API. - Medium]]></description>
        <link>https://medium.com/api-news?source=rss----f8b01052a5f5---4</link>
        <image>
            <url>https://cdn-images-1.medium.com/proxy/1*TGH72Nnw24QL3iV9IOm4VA.png</url>
            <title>Trakt API Blog - Medium</title>
            <link>https://medium.com/api-news?source=rss----f8b01052a5f5---4</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 00:59:13 GMT</lastBuildDate>
        <atom:link href="https://medium.com/feed/api-news" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[API Changelog 2023]]></title>
            <link>https://medium.com/api-news/api-changelog-2023-7c25829bba43?source=rss----f8b01052a5f5---4</link>
            <guid isPermaLink="false">https://medium.com/p/7c25829bba43</guid>
            <category><![CDATA[api]]></category>
            <category><![CDATA[trakt]]></category>
            <category><![CDATA[changelog]]></category>
            <dc:creator><![CDATA[Trakt]]></dc:creator>
            <pubDate>Thu, 05 Jan 2023 06:23:32 GMT</pubDate>
            <atom:updated>2023-06-07T19:00:13.407Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*efYH7tstYVky_0F0Qlj9Xg.jpeg" /></figure><p>Here’s a list of updates and bug fixes to the <a href="http://trakt.tv/"><strong>Trakt</strong></a> API in 2023. View the full <a href="http://docs.trakt.apiary.io/"><strong>API Docs on Apiary</strong></a>. Please ask questions in our <a href="https://github.com/trakt/api-help/discussions"><strong>GitHub project</strong></a>.</p><p>If you’d like to support Trakt, please consider <a href="https://trakt.tv/vip"><strong>signing up for VIP</strong></a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>June 7, 2023</h3><h4>UPDATES</h4><ul><li>The <a href="https://trakt.docs.apiary.io/#reference/authentication-oauth/authorize-application"><strong>OAuth flow</strong></a> can force a sign in page instead of using the signed in session. This is useful for mobile apps with embedded webviews where it’s not easy for the user to sign out.</li><li><a href="https://trakt.docs.apiary.io/#reference/networks/list/get-networks"><strong>/networks</strong></a> method includes the country and ids along with the name of each network.</li><li>Replaced the networks filter with the more accurate network_ids filter. This is way more accurate instead of relying on a name based match.</li></ul><h4>BUGS</h4><ul><li>Improved performance when loading large lists.</li><li>Correctly hide lists with link privacy.</li><li>Fix collection metadata to allow editing existing metadata values.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*3884sW2oP3Z7JJpi.png" /></figure><h3>May 22, 2023</h3><h4>UPDATES</h4><ul><li>Added new methods to update <em>notes</em> on <a href="https://trakt.docs.apiary.io/#reference/users/update-list-item/update-a-list-item"><strong>list items</strong></a>, <a href="https://trakt.docs.apiary.io/#reference/sync/update-personal-recommendation-item-beta/update-a-personal-recommendation-item"><strong>personal recommendation items</strong></a>, and <a href="https://trakt.docs.apiary.io/#reference/sync/update-watchlist-item/update-a-watchlist-item"><strong>watchlist items</strong></a>. Notes on list items and watchlist items are 🔥 <strong>VIP Only</strong> methods.</li></ul><h4>BUGS</h4><ul><li>Allow new lines when adding notes to list items.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>April 16, 2023</h3><h4>UPDATES</h4><ul><li><a href="https://trakt.docs.apiary.io/#reference/users/lists/create-personal-list"><strong>Lists</strong></a> support a new link privacy option. This is essentially a private list, with a share_link to allow anyone with the link to view the list. This is useful for private user profiles that still want to share their lists with others.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>March 30, 2023</h3><h4>UPDATES</h4><ul><li>Added <strong>Mastodon</strong> sharing parameters to <a href="https://trakt.docs.apiary.io/#reference/checkin/checkin/check-into-an-item"><strong>/checkin</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/users/settings/retrieve-settings"><strong>/users/settings</strong></a>.</li><li><a href="https://trakt.docs.apiary.io/#reference/recommendations/movies/get-movie-recommendations"><strong>/recommendations</strong></a> include recommended_by which is an array of all members who recommended the item and any notes they left why. This can be used to replicate the Trakt dashboard and display the avatar and notes.</li></ul><h4>BUGS</h4><ul><li>Fix 500 error with unauthed recommendations.</li><li>Several performance improvments to the <strong>/sync</strong> methods.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>January 5, 2023</h3><h4>BUGS</h4><ul><li>Fixed <a href="https://trakt.docs.apiary.io/#reference/checkin/checkin/check-into-an-item"><strong>/checkin</strong></a> 500 error. <a href="https://github.com/trakt/api-help/issues/387"><strong>(GitHub issue)</strong></a></li><li>Fixed ?watchnow=favorites in <a href="https://trakt.docs.apiary.io/#reference/users/saved-filters/get-saved-filters"><strong>/users/saved_filters</strong></a> to automatically inject all the favorites. <a href="https://github.com/trakt/api-help/issues/388"><strong>(GitHub issue)</strong></a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7c25829bba43" width="1" height="1" alt=""><hr><p><a href="https://medium.com/api-news/api-changelog-2023-7c25829bba43">API Changelog 2023</a> was originally published in <a href="https://medium.com/api-news">Trakt API Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[API Changelog 2022]]></title>
            <link>https://medium.com/api-news/api-changelog-2022-b62be006dd68?source=rss----f8b01052a5f5---4</link>
            <guid isPermaLink="false">https://medium.com/p/b62be006dd68</guid>
            <category><![CDATA[changelog]]></category>
            <category><![CDATA[trakt-api]]></category>
            <category><![CDATA[trakt]]></category>
            <category><![CDATA[api]]></category>
            <dc:creator><![CDATA[Trakt]]></dc:creator>
            <pubDate>Tue, 18 Jan 2022 19:19:10 GMT</pubDate>
            <atom:updated>2023-01-06T00:12:07.587Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7xu9Czgq2pK-6lzOCfkCpg.jpeg" /></figure><p>Here’s a list of updates and bug fixes to the <a href="http://trakt.tv/"><strong>Trakt</strong></a> API in 2022. View the full <a href="http://docs.trakt.apiary.io/"><strong>API Docs on Apiary</strong></a>. Please ask questions in our <a href="https://github.com/trakt/api-help/discussions"><strong>GitHub project</strong></a>.</p><p>If you’d like to support Trakt, please consider <a href="https://trakt.tv/vip"><strong>signing up for VIP</strong></a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>November 14, 2022</h3><h4>UPDATES</h4><ul><li>New methods to get studios <a href="https://trakt.docs.apiary.io/#reference/movies/studios/get-movie-studios"><strong>/movies/:id/studios</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/shows/studios/get-show-studios"><strong>/shows/:id/studios</strong></a>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>November 9, 2022</h3><h4>UPDATES</h4><ul><li>PCKE authentication flow now supported.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>November 3, 2022</h3><h4>UPDATES</h4><ul><li>Added <a href="https://trakt.docs.apiary.io/#reference/people/updates/get-recently-updated-people"><strong>/people/updates</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/people/updated-ids/get-recently-updated-people-trakt-ids"><strong>/people/updates/id</strong></a> methods.</li><li>Added updated_at to person objects.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>October 26, 2022</h3><h4>BUGS</h4><ul><li>Fixed actor headshots if they are a host character <em>(i.e. Doctor Who)</em>.</li><li>Fixed movie runtime to make sure it’s not null.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>September 12, 2022</h3><h4>BUGS</h4><ul><li>Fixed 500 error on <a href="https://trakt.docs.apiary.io/#reference/comments/recent/get-recently-created-comments"><strong>/comments/recent/all</strong></a> method — <a href="https://github.com/trakt/api-help/issues/364"><strong>GitHub issue</strong></a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>August 28 2022</h3><h4>UPDATES</h4><ul><li>Added <strong>Donghua</strong> genre <em>(Chinese Animation)</em></li></ul><h4>BUGS</h4><ul><li>Fixed <a href="https://trakt.docs.apiary.io/#reference/seasons/translations/get-all-season-translations"><strong>/shows/:id/season/:season_number/translations</strong></a> method, it sometimes returned a 500 error.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>June 28, 2022</h3><h4>UPDATES</h4><ul><li><a href="https://trakt.docs.apiary.io/#reference/sync/add-to-personal-recommendations-beta/add-items-to-personal-recommendations"><strong>Recommendations</strong></a> enforce a 50 item limit. <a href="https://blog.trakt.tv/recommend-your-favorites-4253bf79364b"><strong>Read more</strong></a> about this feature and why it’s limited.</li><li><a href="https://trakt.docs.apiary.io/#reference/users/collaborations/get-all-lists-a-user-can-collaborate-on"><strong>/users/:id/lists/collaborations</strong></a> returns all lists a user has permission to collaborate on. Access a collaboration list like normal, and the OAuth user will have permissions to view items, add items, and remove items.</li><li><a href="https://trakt.docs.apiary.io/#reference/users/saved-filters/get-saved-filters"><strong>/users/saved_filters</strong></a> returns all advanced filters a user has created. This is a great alternative to creating and maintaining personal lists. In some cases, the data is already there via a filter.</li></ul><h4>BUGS</h4><ul><li>Fixed official lists to ensure they always return a user object.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>June 14, 2022</h3><h4>UPDATES</h4><ul><li>List limits are enforced as of today. <a href="https://github.com/trakt/api-help/discussions/350"><strong>Please ask questions or discuss in GitHub</strong></a>.</li><li>Official lists are returned in the <a href="https://trakt.docs.apiary.io/#reference/search/text-query/get-text-query-results"><strong>search method</strong></a>. Each list object contains a type value set to personal or official.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>June 6, 2022</h3><h4>UPDATES</h4><ul><li>Translations include the country, so we can include all language+country combinations instead of just a single language. This update applies to <a href="https://trakt.docs.apiary.io/#reference/movies/translations/get-all-movie-translations"><strong>movie</strong></a>, <a href="https://trakt.docs.apiary.io/#reference/shows/translations/get-all-show-translations"><strong>show</strong></a>, <a href="https://trakt.docs.apiary.io/#reference/seasons/translations/get-all-season-translations"><strong>season</strong></a>, and <a href="https://trakt.docs.apiary.io/#reference/episodes/translations/get-all-episode-translations"><strong>episode</strong></a> translations.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>May 24, 2022</h3><h4>LIST LIMITS</h4><ul><li>List limits will be enforced starting June 14, 2022. <a href="https://github.com/trakt/api-help/discussions/350"><strong>Please ask questions or discuss in GitHub</strong></a>.</li></ul><pre>VIP Members</pre><pre>* Unlimited lists<br>* 10,000 items on your watchlist<br>* 10,000 items on a personal list<br>* notes on each list item</pre><pre>New Members</pre><pre>* 5 personal lists<br>* 1,000 items on your watchlist<br>* 500 items on a personal list</pre><pre>Existing Members</pre><pre>* 10 personal lists<br>* 2,000 items on your watchlist<br>* 1,000 items on a personal list</pre><h4>VIP UPDATES (<a href="http://trakt.tv/vip">more info</a>)</h4><ul><li>We’re introducting the concept of 🔥 <a href="https://trakt.docs.apiary.io/#introduction/vip-methods"><strong>VIP Enhanced</strong></a> API methods. A 420 HTTP status code is returned when the user has exceeded their account limits. Signing up for <a href="https://trakt.tv/vip"><strong>Trakt VIP</strong></a> will increase these limits. If the user isn’t a VIP, please open a browser to X-Upgrade-URL so the user can sign up for Trakt VIP. If they are already VIP and still exceeded the limit, please display a message indicating this.</li><li>notes can be added to all list items <em>(</em><a href="https://trakt.docs.apiary.io/#reference/users/add-list-items/add-items-to-personal-list"><strong><em>personal lists</em></strong></a><em>, </em><a href="https://trakt.docs.apiary.io/#reference/sync/add-to-watchlist/add-items-to-watchlist"><strong><em>watchlist</em></strong></a><em>, </em><a href="https://trakt.docs.apiary.io/#reference/sync/add-to-personal-recommendations-beta/add-items-to-personal-recommendations"><strong><em>recommendations</em></strong></a><em>)</em>.</li></ul><h4>UPDATES</h4><ul><li><strong>/users/settings</strong> includes all limits for a user’s account.</li></ul><pre>&quot;limits&quot;: {<br>    &quot;list&quot;: {<br>        &quot;count&quot;: 5,<br>        &quot;item_count&quot;: 250<br>    },<br>    &quot;watchlist&quot;: {<br>        &quot;item_count&quot;: 250<br>    },<br>    &quot;recommendations&quot;: {<br>        &quot;item_count&quot;: 50<br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>April 28, 2022</h3><h4>UPDATES</h4><ul><li>Season translations available using <a href="https://trakt.docs.apiary.io/#reference/seasons/translations/get-all-season-translations"><strong>/shows/:id/season/:season_number/translations</strong></a>.</li><li>Improved performance of <a href="https://trakt.docs.apiary.io/#reference/sync/playback/get-playback-progress"><strong>/sync/playback</strong></a>.</li><li><a href="https://trakt.docs.apiary.io/#introduction/filters"><strong>API docs</strong></a> updated to all status options.</li><li><a href="https://trakt.docs.apiary.io/#reference/users/likes/get-likes"><strong>/users/:id/likes/comments</strong></a> can optionally include media objects for each comment like.</li><li>Expose more CORS headers: X-Ratelimit, Retry-After, X-Upgrade-URL, X-Applied-Sort-By, X-Applied-Sort-How, Cache-Control, Pragma, Expires</li><li>Added requested_at to <a href="https://trakt.docs.apiary.io/#reference/sync/last-activities/get-last-activity"><strong>/sync/last_activities</strong></a> which is set when the OAuth user has a private account and someone requests to follow them.</li><li>Return updated_at and item_count when adding, deleting, or re-ordering list <em>(personal list, watchlist, recommendations)</em> items.</li></ul><h4>BUGS</h4><ul><li>Fixed caching on <a href="https://trakt.docs.apiary.io/#reference/shows/watched-progress/get-show-watched-progress"><strong>/shows/:id/progress</strong></a> methods.</li><li>Fixed 500 error on <a href="https://trakt.docs.apiary.io/#reference/sync/get-collection/get-collection"><strong>/sync/collection</strong></a>.</li><li>Make sure listed_at isn’t <em>null</em> on <a href="https://trakt.docs.apiary.io/#reference/users/list-items/get-items-on-a-personal-list"><strong>/users/:id/lists/:list_id/items</strong></a>.</li><li>Fixed audio channel output for 10.1. <a href="https://github.com/trakt/api-help/issues/272"><strong>(GitHub)</strong></a></li><li>Make sure episodes key is always returned in /shows/:id/seasons?extended=episodes. <a href="https://github.com/trakt/api-help/issues/135"><strong>(GitHub)</strong></a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*unhcqkTO0pjpGP8p.png" /></figure><h3>March 15, 2022</h3><h4>UPDATES</h4><ul><li>Episode <em>runtime</em> is automatically added when released is used for the watched_at and collected_at date in <a href="https://trakt.docs.apiary.io/#reference/sync/add-to-history/add-items-to-watched-history"><strong>/sync/watched</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/sync/add-to-collection/add-items-to-collection"><strong>/sync/collection</strong></a>.</li><li>Comment users can be <a href="https://trakt.docs.apiary.io/#reference/users/add-hidden-items/add-hidden-items"><strong>blocked</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/users/remove-hidden-items/remove-hidden-items"><strong>unblocked</strong></a> using the <strong>/users/hidden</strong> methods.</li><li><a href="https://trakt.docs.apiary.io/#reference/sync/last-activities/get-last-activity"><strong>/sync/last_activities</strong></a> includes the timestamp when a comment user was last blocked.</li><li><a href="https://trakt.docs.apiary.io/#reference/users/likes/get-likes"><strong>/users/:id/likes</strong></a> changed to a public method.</li></ul><h4>BUGS</h4><ul><li>Fixed pagination in <a href="https://trakt.docs.apiary.io/#reference/movies/related/get-related-movies"><strong>/movies/:id/related</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/shows/related/get-related-shows"><strong>/shows/:id/related</strong></a>.</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b62be006dd68" width="1" height="1" alt=""><hr><p><a href="https://medium.com/api-news/api-changelog-2022-b62be006dd68">API Changelog 2022</a> was originally published in <a href="https://medium.com/api-news">Trakt API Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[API Changelog 2021]]></title>
            <link>https://medium.com/api-news/api-changelog-2021-8c191a2ab65c?source=rss----f8b01052a5f5---4</link>
            <guid isPermaLink="false">https://medium.com/p/8c191a2ab65c</guid>
            <category><![CDATA[changelog]]></category>
            <category><![CDATA[trakt]]></category>
            <dc:creator><![CDATA[Trakt]]></dc:creator>
            <pubDate>Fri, 11 Jun 2021 18:37:39 GMT</pubDate>
            <atom:updated>2022-01-18T19:19:40.194Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rPNIDItgHPizBkSUNykYLA.jpeg" /></figure><p>Here’s a list of updates and bug fixes to the <a href="http://trakt.tv/"><strong>Trakt</strong></a> API in 2021. View the full <a href="http://docs.trakt.apiary.io/"><strong>API Docs on Apiary</strong></a>. Please ask questions in our <a href="https://github.com/trakt/api-help/discussions"><strong>GitHub project</strong></a>.</p><p>If you’d like to support Trakt, please consider <a href="https://trakt.tv/vip"><strong>signing up for VIP</strong></a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*vUdTLBeWk_nt4zNF.png" /></figure><h3>July 12, 2021</h3><h4>VIP ONLY <a href="https://trakt.tv/vip">(more info)</a></h4><ul><li>We’re starting to create <a href="https://trakt.docs.apiary.io/#introduction/vip-only-methods"><strong>VIP only methods</strong></a> so your app can offer some features from the website experience.</li><li>Reset show watched progress using <a href="https://trakt.docs.apiary.io/#reference/shows/reset-watched-progress/reset-show-progress"><strong>/shows/id/progress/watched/reset</strong></a> and optionally include the <em>reset_at</em> date.</li></ul><h4>UPDATES</h4><ul><li>When using the <strong>/updates</strong> methods the <em>start_date</em> is only accurate to the hour <em>(for caching purposes)</em>. Please drop the minutes and seconds from your timestamp to help optimize our cached data. For example, use<strong><em> 2021–07–17T12:00:00Z</em></strong> and not <strong><em>2021–07–17T12:23:34Z</em></strong>.</li><li>All <strong>/updates</strong> methods only allow <em>30 days</em> in the past as the oldest date. This won’t affect most apps, but some were scraping data by going years in the past and that caused performance issues.</li></ul><h4>BUGS</h4><ul><li>Fixed the watchlist updated timestamp to be more accurate.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*vUdTLBeWk_nt4zNF.png" /></figure><h3>June 11, 2021</h3><h4>UPDATES</h4><ul><li>Reorder watchlist items using <a href="https://trakt.docs.apiary.io/#reference/sync/reorder-watchlist/reorder-watchlist-items"><strong>/sync/watchlist/reorder</strong></a><strong> </strong>and personal recommendations using <a href="https://trakt.docs.apiary.io/#reference/sync/reorder-personal-recommendations/reorder-personally-recommended-items"><strong>/sync/recommendations/reorder</strong></a>. This works the same as reordering personal list items, just in these new sections.</li></ul><h4>BUGS</h4><ul><li>Fixed 500 error on the <a href="https://trakt.docs.apiary.io/#reference/users/watchlist/get-watchlist"><strong>watchlist endpoints</strong></a><strong> </strong>that was caused by having a blank watchlist and never having added an item to it.</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8c191a2ab65c" width="1" height="1" alt=""><hr><p><a href="https://medium.com/api-news/api-changelog-2021-8c191a2ab65c">API Changelog 2021</a> was originally published in <a href="https://medium.com/api-news">Trakt API Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Trakt API Images will be removed on October 31, 2016]]></title>
            <link>https://medium.com/api-news/trakt-api-images-56b43c356427?source=rss----f8b01052a5f5---4</link>
            <guid isPermaLink="false">https://medium.com/p/56b43c356427</guid>
            <category><![CDATA[trakt]]></category>
            <category><![CDATA[trakt-api]]></category>
            <category><![CDATA[news]]></category>
            <dc:creator><![CDATA[Trakt]]></dc:creator>
            <pubDate>Fri, 07 Oct 2016 03:42:29 GMT</pubDate>
            <atom:updated>2021-06-11T18:53:38.778Z</atom:updated>
            <content:encoded><![CDATA[<p>Hey guys,</p><blockquote><strong>TLDR; Images will no longer be served from the API starting October 31, 2016 due to greatly increased hosting costs. All other API functions will remain the same.</strong></blockquote><p>We regret that it has come to this, but starting <strong>October 31, 2016</strong>, we will no longer be able to serve images from our API. Our CDN has been amazing for the past 5 years, but as we’ve grown in popularity, the amount of traffic we’ve been pushing through them has gotten to the point that we are costing them an arm and a leg.</p><h4>The nitty gritty details.</h4><ul><li>Monthly traffic: <strong>~1 petabyte</strong> (85%+ images)</li><li>CDN projected cost: <strong>$15,000–20,000/mo</strong></li><li>Trakt currently paying: <strong>$25/mo</strong></li></ul><p>The three of us have been working on a way to keep the Trakt API and website running long into the future. The answer is to reduce the <strong><em>850 terabytes</em></strong> of image traffic we are pushing out of the API each month. We will continue to serve every other aspect of our API and website the same way.</p><h4>The API still provides all this and more!</h4><ul><li>Real time <a href="http://docs.trakt.apiary.io/#reference/scrobble">scrobbling</a>, manual <a href="http://docs.trakt.apiary.io/#reference/checkin/checkin">checkins</a>, and synced <a href="http://docs.trakt.apiary.io/#reference/sync/playback/get-playback-progress">playback progress</a>.</li><li>Syncing your <a href="http://docs.trakt.apiary.io/#reference/sync/add-to-history/add-items-to-watched-history">watched history</a>, <a href="http://docs.trakt.apiary.io/#reference/sync/add-to-collection/add-items-to-collection">collections</a>, and <a href="http://docs.trakt.apiary.io/#reference/sync/add-ratings/add-new-ratings">ratings</a> to use Trakt as a cloud backup and sync between devices.</li><li><a href="http://docs.trakt.apiary.io/#reference/sync/get-watchlist">Watchlists</a> and c<a href="http://docs.trakt.apiary.io/#reference/users/lists">ustom lists</a> that you can use for anything.</li><li><a href="http://docs.trakt.apiary.io/#reference/calendars/my-shows/get-shows">Personalized</a> and <a href="http://docs.trakt.apiary.io/#reference/calendars/all-shows/get-shows">global</a> calendars.</li><li><a href="http://docs.trakt.apiary.io/#reference/comments">Commenting</a>, reviews and building your <a href="http://docs.trakt.apiary.io/#reference/users/follow/follow-this-user">social graph</a>.</li><li><a href="http://docs.trakt.apiary.io/#reference/shows/summary/get-a-single-show">TV show</a> and <a href="http://docs.trakt.apiary.io/#reference/movies/summary/get-a-movie">movie</a> metadata.</li><li><a href="http://docs.trakt.apiary.io/#reference/movies/trending/get-trending-movies">Content</a> <a href="http://docs.trakt.apiary.io/#reference/shows/trending/get-trending-shows">discovery</a> and <a href="http://docs.trakt.apiary.io/#reference/search/text-query/get-text-query-results">advanced searching</a>.</li></ul><h4>Transitioning.</h4><p>The transition to other image resources should be smooth since Trakt provides IDs for services like TMDB, TVDB, Fanart.tv, and OMDB. All of these services have APIs which provide images. <a href="https://apiblog.trakt.tv/how-to-find-the-best-images-516045bcc3b6">We wrote an article to help with this.</a></p><p>All three of us are sad this has to happen, but unfortunately it must in order to keep the servers up and running. Removing images provides long term stability for the Trakt API and website.</p><p>If you have any questions, please <a href="https://plus.google.com/communities/103111515647012208243">join the Google+ API community</a>.</p><p>Thank you — <em><br>Justin, Sean &amp; Jimmy</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=56b43c356427" width="1" height="1" alt=""><hr><p><a href="https://medium.com/api-news/trakt-api-images-56b43c356427">Trakt API Images will be removed on October 31, 2016</a> was originally published in <a href="https://medium.com/api-news">Trakt API Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[How to find the best images]]></title>
            <link>https://medium.com/api-news/how-to-find-the-best-images-516045bcc3b6?source=rss----f8b01052a5f5---4</link>
            <guid isPermaLink="false">https://medium.com/p/516045bcc3b6</guid>
            <category><![CDATA[trakt-api]]></category>
            <category><![CDATA[trakt]]></category>
            <category><![CDATA[api]]></category>
            <category><![CDATA[tutorial]]></category>
            <dc:creator><![CDATA[Trakt]]></dc:creator>
            <pubDate>Fri, 07 Oct 2016 01:00:47 GMT</pubDate>
            <atom:updated>2021-06-11T18:54:13.151Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Mup6Ji7RNZtIHCnT9zgkeQ.jpeg" /></figure><p>The Trakt API returns <a href="http://docs.trakt.apiary.io/#introduction/standard-media-objects"><strong>standard media objects</strong></a> for all movie, show, season, episode, and person items and includes an ids object for each. These ids map to other services like <a href="https://www.themoviedb.org/"><strong>TMDB</strong></a>, <a href="https://thetvdb.com/"><strong>TVDB</strong></a>, <a href="https://fanart.tv/"><strong>Fanart.tv</strong></a>, <a href="http://imdb.com/"><strong>IMDB</strong></a>, and <a href="http://omdbapi.com/"><strong>OMDB</strong></a>. For example, here’s what a show object looks like.</p><pre>{<br>  &quot;title&quot;: &quot;Breaking Bad&quot;,<br>  &quot;year&quot;: 2008,<br>  &quot;ids&quot;: {<br>    &quot;trakt&quot;: 1,<br>    &quot;slug&quot;: &quot;breaking-bad&quot;,<br>    &quot;tvdb&quot;: 81189,<br>    &quot;imdb&quot;: &quot;tt0903747&quot;,<br>    &quot;tmdb&quot;: 1396,<br>    &quot;tvrage&quot;: 18164<br>  }<br>}</pre><p>Most of the above services have APIs that you can use to grab lots of great looking images. Below, we’ll gives details on what artwork we use to power the <a href="https://trakt.tv/"><strong>Trakt.tv</strong></a> website.</p><h3>Support the image sources!</h3><p>A lot of media center and app users don’t realize their images are powered by <a href="https://www.themoviedb.org/"><strong>TMDB</strong></a>, <a href="https://thetvdb.com/"><strong>TVDB</strong></a>, <a href="https://fanart.tv/"><strong>Fanart.tv</strong></a>, and <a href="http://omdbapi.com/"><strong>OMDB</strong></a>. Donating and bringing awareness to these sources is a positive thing for the entire community and we encourage you to do so!</p><h3>Which sites have which artwork?</h3><p>Here’s a chart to help you locate where to grab the artwork you need. You should experiment and see what looks best in your app.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CsyT9QrQSiQPQpG220S47Q.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>TV Shows</h3><p>Here’s how we cache TV show images for the Trakt.tv website.</p><h4>Poster &amp; Fanart</h4><p>The highest rated poster and fanart are imported from TMDB. 1080p (or larger) is preferred for fanart and we fall back to 720p if nothing better is available. If no image exists on TMDB, we import from TVDB with the same 1080p preference.</p><h4>Season Posters</h4><p>The highest rated season posters are imported from TMDB. If no season poster exists, we import from TVDB.</p><h4>Episode Screenshots</h4><p>The highest rated episode screenshots are imported from TMDB since they support 1080p (and higher) resolutions. If no screenshot exists on TMDB, we import from TVDB.</p><h4>Additional Images</h4><p>Supporting TV show images such as logo, banner, and thumb are imported from Fanart.tv. If the no banner exists, we import from TVDB.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>Movies</h3><p>Here’s how we cache movie images for the Trakt.tv website.</p><h4>Poster &amp; Fanart</h4><p>The highest rated poster and fanart are imported from TMDB. 1080p (or higher) is preferred for fanart and we fall back to 720p if nothing better is available.</p><h4>Additional Images</h4><p>Supporting movie images such as logo, banner, and thumb are imported from Fanart.tv.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>People</h3><p>Here’s how we cache people images for the Trakt.tv website.</p><h4>Headshot &amp; Fanart</h4><p>The highest rated headshot and fanart are imported from TMDB. 1080p (or higher) is preferred for fanart and we fall back to 720p if nothing better is available.</p><h4>Character Headshot</h4><p>For TV Shows, we import the character headshot from TVDB.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>Caching</h3><p>When dealing with images, it’s important to cache them effectively. You can use a service like <a href="https://aws.amazon.com/s3"><strong>Amazon S3</strong></a> or build a custom image server using <a href="https://www.varnish-cache.org/"><strong>Varnish</strong></a>. Your app should respect all the headers and probably only needs to cache images once since they don’t change much, if ever. Caching helps reduce load on the image source and helps your app load more quickly. It’s a good thing for everyone!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>Join the API community!</h3><p>If you’re not already a member, make sure to <a href="https://plus.google.com/communities/103111515647012208243"><strong>join our Google+ API community</strong></a>. This is the best place to discuss all things related to the API with the Trakt team and other developers from the community.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=516045bcc3b6" width="1" height="1" alt=""><hr><p><a href="https://medium.com/api-news/how-to-find-the-best-images-516045bcc3b6">How to find the best images</a> was originally published in <a href="https://medium.com/api-news">Trakt API Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[API Changelog]]></title>
            <link>https://medium.com/api-news/api-changelog-9f4041819718?source=rss----f8b01052a5f5---4</link>
            <guid isPermaLink="false">https://medium.com/p/9f4041819718</guid>
            <category><![CDATA[changelog]]></category>
            <category><![CDATA[trakt]]></category>
            <category><![CDATA[api]]></category>
            <dc:creator><![CDATA[Trakt]]></dc:creator>
            <pubDate>Thu, 18 Feb 2016 07:54:22 GMT</pubDate>
            <atom:updated>2022-01-18T19:17:39.460Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*aENzUoAK3j_xwygT0vKyTQ.jpeg" /></figure><h2>API Changelog 2014–2020</h2><p>Here’s a list of recent updates and bug fixes to the Trakt.tv API. This post will be updated as new things are added to the API.</p><p>View the full <a href="http://docs.trakt.apiary.io/"><strong>API Documentation on Apiary</strong></a>. Also make sure to join our <a href="https://plus.google.com/communities/103111515647012208243"><strong>Google+ community</strong></a> to discuss anything API related. Some updates below have <strong>g+</strong> links to further discuss.</p><p>If you’d like to support Trakt.tv and help us grow the API and website, check out our <a href="https://trakt.tv/vip"><strong>VIP membership</strong></a>.</p><h3>February 1, 2020</h3><h4>UPDATES</h4><ul><li><a href="https://trakt.docs.apiary.io/#reference/sync/get-watchlist/get-watchlist"><strong>/sync/watchlist</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/users/watchlist/get-watchlist"><strong>/users/:id/watchlist</strong></a> allow sorting by rank, added, released, or title. The response also includes 2 new headers X-Applied-Sort-By and X-Applied-Sort-How to know how things are being sorted.</li><li>Various <a href="http://trakt.tv/b/api-docs"><strong>API documentation</strong></a> updates for missing properties.</li></ul><h4>BUGS</h4><ul><li>Fixed CORS for <a href="https://trakt.docs.apiary.io/#reference/authentication-oauth/revoke-token/revoke-an-access_token"><strong>/oauth/revoke</strong></a>.</li><li>Fixed [item] token replacement when using a custom <a href="https://trakt.docs.apiary.io/#reference/checkin/checkin/check-into-an-item"><strong>/checkin</strong></a> message.</li><li>Improved handling of deleted user accounts. This affected a small number of users that deleted their account in the Trakt version 1 days.</li><li>Improved handling of user’s with a super high play count in their watched history.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>August 21, 2019</h3><h4>UPDATES</h4><ul><li><a href="https://trakt.docs.apiary.io/#reference/comments/comments/post-a-comment"><strong>Creating</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/comments/comment/update-a-comment-or-reply"><strong>updating</strong></a> comments will enforce English only comments per our <a href="https://trakt.docs.apiary.io/#reference/comments"><strong>commenting rules</strong></a>. If not English, a <strong>422</strong> HTTP error code and error message will be returned.</li><li>Optional pagination for <a href="https://trakt.docs.apiary.io/#reference/sync/get-ratings/get-ratings"><strong>/sync/ratings</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/users/ratings/get-ratings"><strong>/users/:id/ratings</strong></a>.</li><li>reset_at included in <a href="https://trakt.docs.apiary.io/#reference/sync/get-watched/get-watched"><strong>/sync/watched/shows</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/users/watched/get-watched"><strong>/users/:id/watched/shows</strong></a>. If not null, this timestamp is when the user started re-watching the show. Your app can adjust the progress by ignoring episodes with a last_watched_at prior to the reset_at.</li></ul><h4>BUGS</h4><ul><li><a href="https://trakt.docs.apiary.io/#reference/search/text-query/get-text-query-results"><strong>/search/:type</strong></a> results improved when using&#39; in the search query. iOS sometimes uses ` instead which was breaking the search results, so we automatically swap out that character.</li><li>Crew credits are correctly combined if they have multiple jobs in the same department. Previously, it had the person listed twice.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>May 22, 2019</h3><h4>UPDATES</h4><ul><li><strong>Updated people methods!</strong> You might have noticed the Trakt website has recently started displaying season and episode level cast and crew information. This info is now available in the API! We get all the info from TMDB, so if anything is missing or incorrect, please update it at TMDB. Trakt will automatically refresh about 24 hours later. Most of the major TV shows are already up to date. <a href="https://github.com/trakt/api-help/issues/74"><strong>Discuss on GitHub.</strong></a></li><li><strong>Guest Stars</strong><br>We have a new extended parameter to return guest_stars for the show and season /peoplemethods.</li><li><strong>Episode Count</strong><br>The show and season /people methods return the episode_count for each cast and crew member. We sort the data by the highest episode_count but the raw value is there if you need to display it or use it for other sorting.</li><li><strong>Updated Methods</strong><br>These methods return characters and jobs as an array. The old character and job string fields are DEPRECATED. They are still there so existing apps won&#39;t break, but please transition to the new fields and notice the API docs only have the new fields.<br><a href="https://trakt.docs.apiary.io/#reference/shows/people/get-all-people-for-a-show"><strong>/shows/:id/people</strong></a><br><a href="https://trakt.docs.apiary.io/#reference/movies/people/get-all-people-for-a-movie"><strong>/movie/:id/people</strong></a></li><li>In addition to the new fields mentioned above, the shows method will return episode_count and series_regular for all cast items. These fields are helpful in determining if an actor is just a guest star or had a regular role on a TV show.<br><a href="https://trakt.docs.apiary.io/#reference/people/movies/get-movie-credits"><strong>/people/:id/movies</strong></a><br><a href="https://trakt.docs.apiary.io/#reference/people/shows/get-show-credits"><strong>/people/:id/shows</strong></a></li><li><strong>New Methods</strong><br>These are similar in structure to <a href="https://trakt.docs.apiary.io/#reference/shows/people/get-all-people-for-a-show"><strong>/shows/:id/people</strong></a> but contain more granular data for just specific seasons and episodes.<br><a href="https://trakt.docs.apiary.io/#reference/seasons/people/get-all-people-for-a-season"><strong>/shows/:id/seasons/:number/people</strong></a><br><a href="https://trakt.docs.apiary.io/#reference/episodes/people/get-all-people-for-an-episode"><strong>/shows/:id/seasons/:number/episodes/:number/people</strong></a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 27, 2019</h3><h4>UPDATES</h4><ul><li>Newhdr option when adding metadata to <a href="http://docs.trakt.apiary.io/#reference/sync/add-to-collection/add-items-to-collection"><strong>collection items</strong></a>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 19, 2019</h3><h4>UPDATES</h4><ul><li>Emojis are now supported! 💯 🙌<br>We store and serve short codes <em>(i.e. </em><strong><em>:raised_hands:</em></strong><em>)</em> via the API, so your app should parse those back into actual emojis. The API will also accept unicode emojis and auto convert them to short codes behind the scenes, but it’s a bit safer to send us short codes if you can. <strong><em>Note:</em></strong><em> We use </em><a href="https://www.emojione.com/"><strong><em>EmojiOne</em></strong></a><em> on the Trakt website to render emojis and they have mobile libraries that might be useful for your app.</em> <a href="https://github.com/trakt/api-help/issues/40"><strong>(github)</strong></a></li><li>All the <a href="https://trakt.docs.apiary.io/#reference/comments"><strong>comments</strong></a> methods support Emoji and are indicated in the docs for quick reference. In addition to comments and replies, we’d also recommend handling emojis in list descriptions, user display name, user about, and user location.</li><li>Filter out collected items from <a href="https://trakt.docs.apiary.io/#reference/recommendations"><strong>/recommendations</strong></a>. This is useful to not suggestion items a user already owns.</li></ul><h3>January 25, 2019</h3><h4>API Help</h4><ul><li><a href="https://github.com/trakt/api-help/issues"><strong>We’ve moved to GitHub!</strong></a> Since Google+ is shutting down soon, please watch the GitHub project and configure notifications so you don’t miss important announcements and discussions.</li></ul><h4>UPDATES</h4><ul><li><a href="https://trakt.docs.apiary.io/#reference/scrobblehttps://trakt.docs.apiary.io/#reference/scrobble"><strong>/scrobble</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/checkin"><strong>/checkin</strong></a> accept absolute numbers for episodes. This can be helpful when watching Anime.</li><li><strong><em>My</em></strong> <a href="https://trakt.docs.apiary.io/#reference/calendars"><strong>calendars</strong></a><strong> </strong>include individual episodes on the user’s watchlist.</li><li><a href="https://trakt.docs.apiary.io/#reference/shows/collection-progress/get-show-collection-progress"><strong>/shows/:id/progress/collection</strong></a><strong> </strong>and <a href="https://trakt.docs.apiary.io/#reference/shows/watched-progress/get-show-watched-progress"><strong>/shows/:id/progress/watched </strong></a>accept a new last_activity URL parameter. By default, the last_episode and next_episode are calculated using the last aired episode the user has watched, even if they&#39;ve watched older episodes more recently. To use their last watched episode for these calculations, set the last_activity flag to collected or watched respectively.</li><li>In <a href="https://trakt.docs.apiary.io/#reference/sync/get-watched/get-watched"><strong>/sync/watched/movies</strong></a>, each movie object contains last_watched_at and last_updated_at timestamps. Since users can set custom dates when they watched movies, it is possible for last_watched_at to be in the past. We also include last_updated_at to help sync Trakt data with your app. Cache this timestamp locally and only re-process the movie if you see a newer timestamp.</li><li>In <a href="https://trakt.docs.apiary.io/#reference/sync/get-collection/get-collection"><strong>/sync/collected/movies</strong></a><strong>, </strong>each movie object contains collected_at and updated_at timestamps. Since users can set custom dates when they collected movies, it is possible for collected_at to be in the past. We also include updated_atto help sync Trakt data with your app. Cache this timestamp locally and only re-process the movie if you see a newer timestamp.</li><li>New <a href="https://trakt.docs.apiary.io/#reference/countries/list/get-countries"><strong>/countries</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/languages/get-watched"><strong>/languages</strong></a><strong> </strong>methods to returns all countries and languages we have for movies and shows. Useful when <a href="https://trakt.docs.apiary.io/#introduction/filters"><strong>filtering</strong></a>.</li><li><a href="https://trakt.docs.apiary.io/#reference/users/comments/get-comments"><strong>/users/:id/comments</strong></a><strong> </strong>can return replies only.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>December 12, 2018</h3><h4>UPDATES</h4><ul><li>Added last_updated_at to <a href="https://trakt.docs.apiary.io/#reference/sync/get-watched/get-watched"><strong>/sync/watched/shows</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/sync/get-collection/get-collection"><strong>/sync/collected/shows</strong></a>.</li><li>Reorder a custom lists using <a href="https://trakt.docs.apiary.io/#reference/users/reorder-lists/reorder-a-user&#39;s-lists"><strong>/users/:id/lists/reorder</strong></a>.</li><li>Reorder items on a custom list using <a href="https://trakt.docs.apiary.io/#reference/users/reorder-list-items/reorder-items-on-a-list"><strong>/users/:id/lists/:list_id/items/reorder</strong></a>.</li><li>The user’s preferred date_format is returned under account in <a href="https://trakt.docs.apiary.io/#reference/users/settings/retrieve-settings"><strong>/users/settings</strong></a>. The values can be <em>mdy</em>, <em>dmy</em>, <em>ymd</em>, or <em>ydm</em>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>September 19, 2018</h3><h4>UPDATES</h4><ul><li>As of August 1, <a href="https://developers.facebook.com/blog/post/2018/07/31/platform-update-publish-permission/"><strong>Facebook has disabled automatic sharing</strong></a> to your timeline. Unfortunately, we’ve had to remove to functionality from Trakt. If Facebook decides to allow timeline sharing again, we’ll add it back.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>August 28, 2018</h3><h4>UPDATES</h4><ul><li>Optimized several static API methods related to TV show and movie metadata. These methods should cache better at Cloudflare and be faster to access.</li><li>Several documentation updates.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>May 23, 2018</h3><h4>UPDATES</h4><ul><li>Allow another scrobble of the same item if the full runtime has elapsed. Not a super common use case, but it might happen where you watch the same thing back to back.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 16, 2018</h3><h4>UPDATES</h4><ul><li>New lists methods <a href="https://trakt.docs.apiary.io/#reference/lists/trending/get-trending-lists"><strong>/lists/trending</strong></a> and <a href="https://trakt.docs.apiary.io/#reference/lists/popular/get-popular-lists"><strong>/lists/popular</strong></a> to help with lists discovery. To get items for a list, still use <a href="https://trakt.docs.apiary.io/#reference/users/list-items/get-items-on-a-custom-list"><strong>/users/:id/lists/:list_id/items</strong></a>.</li><li>New <a href="https://trakt.docs.apiary.io/#reference/comments/trending/get-trending-comments"><strong>/comments/trending</strong></a> method returns all comments with the most likes and replies over the last 7 days. There is also <a href="https://trakt.docs.apiary.io/#reference/comments/updates/get-recently-updated-comments"><strong>/comments/updates</strong></a> to return recently updated comments and bump those up along with new comments.</li><li>Replies can be optionally included in the <a href="https://trakt.docs.apiary.io/#reference/comments/trending/get-trending-comments"><strong>/comments/trending</strong></a>, <a href="https://trakt.docs.apiary.io/#reference/comments/recent/get-recently-created-comments"><strong>/comments/recent</strong></a>, <a href="https://trakt.docs.apiary.io/#reference/comments/like/get-recently-updated-comments"><strong>/comments/updates</strong></a>, and <a href="https://trakt.docs.apiary.io/#reference/users/comments/get-comments"><strong>/users/:id/comments</strong></a> by using the include_replies variable. This should only be used if you are specifically trying to surface replies in your app. Anything other than parent_id <em>== 0</em> indicates it is reply.</li><li>List items using the <a href="https://trakt.docs.apiary.io/#reference/users/list-items/get-items-on-a-custom-list"><strong>/users/:id/lists/:list_id/items/:type</strong></a> can be filtered by multiple types, just separate them by a comma.</li><li>When <a href="https://trakt.docs.apiary.io/#reference/users/lists/create-custom-list"><strong>creating</strong></a> or <a href="https://trakt.docs.apiary.io/#reference/users/list/update-custom-list"><strong>updating</strong></a> lists, sorting optionssort_by and sort_how can be optionally set. By default, it sorts by <em>rank asc</em>.</li><li>New <a href="https://trakt.docs.apiary.io/#reference/people/lists/get-lists-containing-this-person"><strong>/people/:id/lists</strong></a> method to get all list the person is listed on.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>February 9, 2018</h3><h4>UPDATES</h4><ul><li><a href="https://trakt.docs.apiary.io/#reference/comments/comment/get-a-comment-or-reply"><strong>/comments/:id</strong></a> includes new headers <em>X-Item-ID</em> and <em>X-Item-Type</em> to help quickly identify the media item the comment is attached to. Check your local cached data first using this info.</li><li>New <a href="https://trakt.docs.apiary.io/#reference/comments/item/get-the-attached-media-item"><strong>/comments/:id/item</strong></a> method returns the attached media object for the comment. Support media objects include movie, show, season, episode, and list.</li><li>New <a href="https://trakt.docs.apiary.io/#reference/comments/recent/get-recent-comments"><strong>/comments/recent</strong></a> method returns the most recent comments across all of Trakt. You can filter by comment_type and media type too.</li><li>New <a href="https://trakt.docs.apiary.io/#reference/comments/likes/get-all-users-who-liked-a-comment"><strong>/comments/:id/likes</strong></a> method returns all users who liked a comment. If you only need the repliescount, the main comment object already has that, so no need to use this method.</li><li><a href="https://trakt.docs.apiary.io/#reference/movies/summary/get-a-movie"><strong>/movies/:id?extended=full</strong></a> returns the country code if we have it.</li><li>Added comment_count field to movie, show,and episode extended full info.</li></ul><h4>BUGS</h4><ul><li>Improved search results when the title matches Trakt exactly. Those results are moved to the top of the results.</li><li>Accented characters are handled better when searching. Behind the scenes, we’ll store the accented and non-accented title so either one will return a match.</li><li>Fixed cache headers on some comment methods.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>October 9, 2017</h3><h4>UPDATES</h4><ul><li>Added a <em>last_episode</em> object to <a href="http://docs.trakt.apiary.io/#reference/shows/watched-progress/get-show-watched-progress"><strong>/show/:id/progress/watched</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/shows/collection-progress/get-show-collection-progress"><strong>/show/:id/progress/collected</strong></a>.</li><li>Added dolby_atmos and dts_x as audio options when adding metadata to <a href="http://docs.trakt.apiary.io/#reference/sync/add-to-collection/add-items-to-collection"><strong>collection items</strong></a>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>September 4, 2017</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/seasons/summary/get-all-seasons-for-a-show"><strong>/show/:id/seasons</strong></a> returns season specific networks with full extended info. We need to update this info manually, so please <a href="https://support.trakt.tv/"><strong>open a support idea</strong></a> with any season network changes we should make.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>July 5, 2017</h3><h4>UPDATES</h4><ul><li>CORS allows custom headers to be correctly accessed by the web browser: <em>X-Pagination-Page, X-Pagination-Page-Count, X-Pagination-Limit, X-Pagination-Item-Count, X-Trending-User-Count, X-Start-Date, X-End-Date, X-Sort-By, X-Sort-How, </em>and<em> X-Private-User.</em></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>April 21, 2017</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/certifications/list/get-certifications"><strong>/certifications</strong></a> method to get TV and movie content ratings.</li><li><a href="http://docs.trakt.apiary.io/#reference/networks/list/get-networks"><strong>/networks</strong></a> method to get TV show network list.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>February 23, 2017</h3><h4>UPDATES</h4><ul><li>Added <em>created_at</em> to the response for <a href="http://docs.trakt.apiary.io/#reference/authentication-oauth/get-token/exchange-code-for-access_token"><strong>/oauth/token</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/authentication-devices/get-token/poll-for-the-access_token"><strong>/oauth/device/token</strong></a>. This matches the OAuth spec.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>February 15, 2017</h3><h4>UPDATES</h4><ul><li>New methods to <a href="http://docs.trakt.apiary.io/#reference/users/add-hidden-items"><strong>hide</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/users/remove-hidden-items"><strong>unhide</strong></a> items from a user’s calendar, watched progress, collected progress, and recommendations. This can help unify the experience between your app, the Trakt.tv website, and other apps.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>January 18, 2017</h3><h4>UPDATES</h4><ul><li>New methods to get lists for an item including <a href="http://docs.trakt.apiary.io/#reference/movies/lists"><strong>/movies/:id/lists</strong></a>, <a href="http://docs.trakt.apiary.io/#reference/shows/lists"><strong>/shows/:id/lists</strong></a>, <a href="http://docs.trakt.apiary.io/#reference/seasons/lists"><strong>/shows/:id/seasons/:number/lists</strong></a>, and <a href="http://docs.trakt.apiary.io/#reference/episodes/lists"><strong>/shows/:id/seasons/:number/episodes/:number/lists</strong></a>. By default, the most <em>popular</em> <em>personal</em> lists will be returned.</li><li>Improved performance for several <a href="http://docs.trakt.apiary.io/#reference/sync"><strong>/sync</strong></a> related methods.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>December 19, 2016</h3><h4>UPDATES</h4><ul><li>Improved <a href="http://docs.trakt.apiary.io/#reference/search/text-query/get-text-query-results"><strong>search results</strong></a> which boost up phrase matches <em>(2+ words)</em> and items with higher vote counts. This helps return more relevant results earlier in the results. <strong>Note:</strong> This is only available in the new search methods released on June 30.</li><li>Episode specific runtimes are returned with full extended info. It will fall back to using the main show runtime for any episodes without a specific runtime.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>November 16, 2016</h3><h4>UPDATES</h4><ul><li>New <em>Anime</em> <a href="http://docs.trakt.apiary.io/#reference/genres/list/get-genres"><strong>genre</strong></a> to better separate movies and TV shows from the more general <em>Animation</em> genre. Anything tagged on <a href="http://www.themoviedb.org/"><strong>TMDB</strong></a> with <em>anime</em> will be added to this new genre.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>November 11, 2016</h3><h4>UPDATES</h4><ul><li>New methods <a href="http://docs.trakt.apiary.io/#reference/calendars/my-dvd/get-dvd-releases"><strong>/calendars/my/dvd</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/calendars/all-dvd/get-dvd-releases"><strong>/calendars/all/dvd</strong></a> to get personalized or global DVD &amp; Blu-ray releases. We get this info from <a href="http://themoviedb.org/"><strong>TMDB</strong></a> so if anything is missing, please add the missing release date over there and Trakt will sync up the next day.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>November 3, 2016</h3><h4>BUGS</h4><ul><li>Some calendar methods would return an error if the user has over 1,000 unique shows. That’s a lot of shows!</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>October 31, 2016</h3><h4>UPDATES</h4><ul><li>Images will no longer be served through the API due to greatly increased hosting costs. All image paths will return null in the response just like it does currently for a missing image. All other API functions will remain the same. <a href="https://apiblog.trakt.tv/trakt-api-images-56b43c356427"><strong>More info.</strong></a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>October 25, 2016</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/shows/summary/get-a-single-show"><strong>/show/:id</strong></a> with full extended data now includes episode_count and season_count fields.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>October 11, 2016</h3><h4>UPDATES</h4><ul><li>New methods <a href="http://docs.trakt.apiary.io/#reference/shows/next-episode"><strong>/shows/:id/next_episode</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/shows/last-episode"><strong>/shows/:id/last_episode</strong></a> to quickly get the next airing and last aired episodes.</li><li><a href="http://docs.trakt.apiary.io/#reference/checkin/checkin/check-into-an-item"><strong>/checkin</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/scrobble/stop/stop-or-finish-watching-in-a-media-center"><strong>/scrobble/stop</strong></a> each return the history id which can be used to reference the event directly.</li></ul><h4>BUGS</h4><ul><li>Fixed a 500 error when trying to get related items for some movies and shows.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>September 14, 2016</h3><h4>BUGS</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/calendars"><strong>/calendars/my/*</strong></a> correctly returns an empty array for brand new users since they don’t have any show or movie activity yet.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>September 8, 2016</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/search/text-query/get-text-query-results"><strong>/search/:type</strong></a> supports an optional <em>fields</em> parameter to have the query only look in certain fields. For example, you might only want to search for movie titles, but not other text fields like tagline and overview. <a href="http://docs.trakt.apiary.io/#reference/search/text-query/get-text-query-results"><strong>Check the docs</strong></a> for a full list of supported <em>fields</em> for each media object <em>type</em>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>September 2, 2016</h3><h4>BUGS</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/shows/collection-progress/get-show-collection-progress"><strong>/shows/:id/progress</strong></a> methods calculate the ETag more precisely using last activity date + play count.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>August 23, 2016</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/sync/last-activities/get-last-activity"><strong>/sync/last_activities</strong></a> includes <em>hidden_at</em> timestamps for movies, shows, and seasons. This timestamp is set whenever an item is hidden from the calendar or progress sections.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>August 20, 2016</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/authentication-oauth/revoke-token/revoke-an-access_token"><strong>/oauth/revoke</strong></a> can revoke unneeded access tokens when a user signs out of their Trakt.tv account in your app. This is not required, but might improve the user experience so the user doesn’t have an unused app connection hanging around.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>August 1, 2016</h3><h4>UPDATES</h4><ul><li>All user objects return the <em>slug</em> which should be used when constructing <strong>/users</strong> URLs. The slug is a URL safe and globally unique version of the username. For most users, the <em>slug</em> will match the <em>username</em>, but in some cases it will be different so the slug should always be used. Docs have also been updated throughout.</li></ul><pre>{<br>  &quot;username&quot;: &quot;justin&quot;,<br>  &quot;private&quot;: false,<br>  &quot;name&quot;: &quot;Justin N.&quot;,<br>  &quot;vip&quot;: true,<br>  &quot;vip_ep&quot;: true,<br>  &quot;ids&quot;:{<br>    &quot;slug&quot;:&quot;justin&quot;<br>  }<br>}</pre><ul><li>Optional <a href="http://docs.trakt.apiary.io/#introduction/pagination"><strong>pagination</strong></a> supported in <a href="http://docs.trakt.apiary.io/#reference/sync/get-watchlist/get-watchlist"><strong>/sync/watchlist</strong></a>, <a href="http://docs.trakt.apiary.io/#reference/users/watchlist/get-watchlist"><strong>/users/:id/watchlist</strong></a>, and <a href="http://docs.trakt.apiary.io/#reference/users/list-items/get-items-on-a-custom-list"><strong>/users/:id/lists/:list_id/items</strong></a> methods. By default, all items are returned. Sending a <em>page</em> or <em>limit</em> will switch to paginated results, including the extra headers.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>June 30, 2016</h3><h4>UPDATES</h4><ul><li>New search methods <a href="http://docs.trakt.apiary.io/#reference/search/text-query/get-text-query-results"><strong>/search/:type</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/search/id-lookup/get-id-lookup-results"><strong>/search/:id_type/:id</strong></a> default to minimum info and support the extended param.</li><li><a href="http://docs.trakt.apiary.io/#introduction/filters"><strong>Filters</strong></a> added for some <em>movies</em>, <em>shows</em>, and <em>search</em> methods. Applying these optional query parameters refines the results and helps your users more easily discover new items.</li><li>Improved <a href="http://docs.trakt.apiary.io/"><strong>API docs</strong></a> to indicate which methods support extended info and filters.</li></ul><h4>DEPRECATIONS</h4><ul><li>The previous <a href="http://docs.trakt.apiary.io/#reference/search"><strong>/search</strong></a> methods are now deprecated. They’ll continue to work, but aren’t officially supported anymore and you should migrate to the new search methods.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>June 21, 2016</h3><h4>UPDATES</h4><ul><li>All comment related methods return an <em>updated_at</em> attribute. Use this to determine if the comment has been updated since the <em>created_at</em> date.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>June 20, 2016</h3><h4>BUGS</h4><ul><li>Blank <em>genres</em> and <em>available_translations</em> will return [] (empty array) instead of null.</li><li>Better fallback when using outdated slugs to lookup movies and TV shows. Sometimes the main slug gets update if their is a year or title change, but the old slug will continue working.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>June 3, 2016</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/sync/get-history/get-watched-history"><strong>/sync/history</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/users/history/get-watched-history"><strong>/users/:id/history</strong></a> support date ranges using <em>start_at</em> and <em>end_at</em>. These should be sent as UTC datetimes such as <em>2016–06–01T00:00:00.000Z</em>.</li></ul><h4>BUGS</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/seasons/summary/get-all-seasons-for-a-show"><strong>/shows/:id/seasons</strong></a> ordered by season number in ascending order.</li><li>Fixed a 500 error (not that common) with <a href="http://docs.trakt.apiary.io/#reference/movies/trending"><strong>/movies/trending</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/shows/trending"><strong>/shows/trending</strong></a>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>May 24, 2016</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/scrobble/stop"><strong>/scrobble/stop</strong></a> will prevent duplicates if called multiple times for the same item. A <strong>409</strong> status code will be returned if detected as a duplicate. This check should be handled in your app still, but the server side fix helps catch any that slip through.</li></ul><h4>BUGS</h4><ul><li>Fixed a 500 error for some user’s episode ratings.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>April 25, 2016</h3><h4>BUGS</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/users/list-comments/get-all-list-comments"><strong>List comments</strong></a> correctly support the <em>sort</em> variable.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>April 18, 2016</h3><h4>DEPRECATIONS</h4><ul><li>PIN authentication is deprecated. Apps using this auth method will of course continue to work, but please update to <a href="http://docs.trakt.apiary.io/#reference/authentication-devices"><strong>Device Authentication</strong></a><strong> </strong>as soon as you can. The user experience is much better and straighforward.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>April 9, 2016</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/users/list-items/get-items-on-a-custom-list"><strong>/users/:id/lists/:list_id/items</strong></a> allows and optional <em>type</em> filter.</li><li><a href="http://docs.trakt.apiary.io/#reference/search/text-query/get-text-query-results"><strong>List search results</strong></a> will include <em>item_count</em> and <em>username </em>(only for user lists). You can more easily construct the user list URL like <a href="http://docs.trakt.apiary.io/#reference/users/list/get-custom-list"><strong>/users/:id/lists/:list_id</strong></a>. Note that <em>username</em> values will fill in over the next few days.</li><li>All comment methods can be optionally sorted by <em>newest</em> (default), <em>oldest</em>, <em>likes</em>, or <em>replies</em>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 24, 2016</h3><h4>UPDATES</h4><ul><li>Performance updates made to <a href="http://docs.trakt.apiary.io/#reference/sync/remove-from-history/remove-items-from-history"><strong>/sync/history/remove</strong></a>, it should be a lot faster now.</li></ul><h4>BUGS</h4><ul><li><em>Access-Control-Allow-Origin</em> headers added for invalid method calls. This allows the 400 error to pass through correctly.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 13, 2016</h3><h4>UPDATES</h4><ul><li><em>first_aired</em> added to <a href="http://docs.trakt.apiary.io/#reference/seasons/summary/get-all-seasons-for-a-show"><strong>/shows/:id/seasons?extended=full</strong></a>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 8, 2016</h3><h4>UPDATES</h4><ul><li>Calendar methods optimized for speed and cached more effectively. They also allow up to <strong>31</strong> days to be returned <em>(previously it was 30)</em>.</li><li>All calendar methods return HTTP headers with the start and end dates.</li></ul><pre>X-Start-Date: Tue, 08 Mar 2016 00:00:00 GMT<br>X-End-Date: Mon, 14 Mar 2016 23:59:59 GMT</pre><h4>BUGS</h4><ul><li>Some episodes weren’t being returned in the calendar methods, even if they aired on that day <em>(everything is in UTC)</em>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 4, 2016</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/movies/related"><strong>/movies/:id/related</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/shows/related"><strong>/shows/:id/related</strong></a> support true pagination.</li></ul><h4>BUGS</h4><ul><li>Fixed a 500 error for some user’s ratings.</li><li>Fixed a 500 error for some user’s history.</li><li>Fixed progress methods to correctly handle <em>?specials=false </em>and not include specials. (You can also simply not send that param)</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>February 19, 2016</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/authentication-devices"><strong>Device Authentication</strong></a> added for apps without direct web browser access. This includes media center plugins, smart watches, smart TVs, command line scripts, and system services. This replaces PIN Authentication and is a much better user experience.</li><li>Improved OAuth flow to make it more clear which app the user is granting access to. Highly recommended to make sure your app icon is up to date.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wxqt_QN3ra-wbEmglB-BwQ.png" /></figure><ul><li><a href="http://docs.trakt.apiary.io/#reference/sync/remove-from-history/get-ratings"><strong>/sync/ratings</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/users/ratings/get-ratings"><strong>/users/:id/ratings</strong></a> support multiple rating filters. For example, you can send 8,9,10 to get anything rated 8 or higher. <a href="https://plus.google.com/+BrettCannon/posts/Hf6iQtci7ES"><strong>(g+)</strong></a></li><li>Adding <em>?extended=noseasons</em> to <a href="http://docs.trakt.apiary.io/#reference/sync/get-watched/get-watched"><strong>/sync/watched/shows</strong></a> or <a href="http://docs.trakt.apiary.io/#reference/users/watched/get-watched"><strong>/users/:id/watched/shows</strong></a> will remove any season and episode info. This cuts down the JSON response size a lot if you only need a top level list of show’s a user has watched.</li><li><a href="http://docs.trakt.apiary.io/#reference/users/watchlist"><strong>/users/:id/watchlist</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/sync/get-watchlist/get-watchlist"><strong>/sync/watchlist</strong></a> return new headers with the list’s default sorting options.</li></ul><pre>X-Sort-By: rank<br>X-Sort-How: asc</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>January 22, 2016</h3><h4>UPDATES</h4><ul><li>Improved performance for history, checkin, and scrobble when auto removing from the watchlist. No functionality change, but should make those methods a bit faster.</li></ul><h4>BUGS</h4><ul><li>Fixed a 500 error when using <strong>/users/me</strong> with bad authentication headers.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>January 21, 2016</h3><h4>UPDATES</h4><ul><li>Improved performance for <a href="http://docs.trakt.apiary.io/#reference/sync/add-to-collection"><strong>/sync/collection/add</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/sync/remove-from-collection"><strong>/sync/collection/remove</strong></a>.</li><li><a href="http://docs.trakt.apiary.io/#reference/movies/releases"><strong>/movies/:id/releases</strong></a> contains <em>release_type</em> and <em>note</em> for each release. We pull this info from the <a href="http://docs.themoviedb.apiary.io/#reference/movies/movieidreleasedates/get"><strong>TMDB</strong></a><strong> </strong>API.</li><li><a href="http://docs.trakt.apiary.io/#reference/sync/get-ratings"><strong>/sync/ratings</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/users/ratings"><strong>/users/:id/ratings</strong></a> now work without the <em>type</em> filter if you want a full list of all ratings. Use <strong>all</strong> for the <em>type</em> if you still want to filter by a specific <em>rating</em>. Each item in the response also has a new <em>type</em> value. All ratings methods have also been optimized for improved performance.</li><li><a href="http://docs.trakt.apiary.io/#reference/users/hidden-items"><strong>/users/hidden</strong></a> method return HTTP headers with how many pages and items are in the results.</li></ul><pre>X-Pagination-Page-Count: 10<br>X-Pagination-Item-Count: 100</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>January 6, 2016</h3><h4>UPDATES</h4><ul><li>Optional <em>yearly</em> time period added for <a href="http://docs.trakt.apiary.io/#reference/movies/played"><strong>/movies/played</strong></a>, <a href="http://docs.trakt.apiary.io/#reference/movies/watched"><strong>/movies/watched</strong></a>, <a href="http://docs.trakt.apiary.io/#reference/movies/collected"><strong>/movies/collected</strong></a>, <a href="http://docs.trakt.apiary.io/#reference/shows/played"><strong>/shows/played</strong></a>, <a href="http://docs.trakt.apiary.io/#reference/shows/watched"><strong>/shows/watched</strong></a>, and <a href="http://docs.trakt.apiary.io/#reference/shows/collected"><strong>/shows/collected</strong></a>.</li><li><a href="http://docs.trakt.apiary.io/#reference/users/lists"><strong>/users/:id/lists</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/users/list"><strong>/users/:id/lists/:list_id</strong></a> both return <em>sort_by</em> and <em>sort_how</em> fields with the default sorting as set by the user.</li><li><a href="http://docs.trakt.apiary.io/#reference/users/list-items"><strong>/users/:id/lists/:list_id/items</strong></a> returns new headers with the list’s default sorting options.</li></ul><pre>X-Sort-By: rank<br>X-Sort-How: asc</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>December 12, 2015</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/recommendations/movies"><strong>/recommendations/movies</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/recommendations/movies"><strong>/recommendations/shows</strong></a> now supports <em>limit</em>. They both default to 10 results.</li><li><a href="http://docs.trakt.apiary.io/#reference/users/stats"><strong>/users/:id/stats</strong></a> return the <em>minutes</em> watched for movies and episodes.</li><li><a href="http://docs.trakt.apiary.io/#reference/users/lists/get-a-user%27s-custom-lists"><strong>Lists</strong></a> return the <em>created_at</em> date.</li><li>If valid OAuth is sent, additional headers will be sent to better determine it is a data permissions issue and not bad OAuth. <a href="http://docs.trakt.apiary.io/#reference/users"><strong>Read more in the docs.</strong></a></li></ul><pre>X-Private-User: true</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>November 30, 2015</h3><h4>UPDATES</h4><ul><li>Popular <a href="http://docs.trakt.apiary.io/#reference/shows/popular"><strong>TV shows</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/movies/popular"><strong>movies</strong></a> use a better algorithm to sort things.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>November 17, 2015</h3><h4>UPDATES</h4><ul><li>Comments can be posted to Twitter, Facebook, Tumblr, or Medium. By default the user’s settings will be used. Optionally, the <a href="http://docs.trakt.apiary.io/#reference/comments/comments/post-a-comment"><strong>/comments</strong></a> method will accept a <em>sharing</em> array.</li><li>The docs to have more detailed info on the checkin and comments sharing options and social networks available.</li><li><a href="http://docs.trakt.apiary.io/#introduction/pagination"><strong>Pagination docs</strong></a> have more details on the headers returned.</li><li>Added a list of <a href="http://docs.trakt.apiary.io/#introduction/third-party-libraries"><strong>Third Party Libraries</strong></a> to the API docs. Please help us keep this list up to date.</li></ul><h4>BUGS</h4><ul><li>Years will be auto removed from TV show titles. This would happen for shows on TVDB (and not TMDB) since they include the year a lot of times.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>November 12, 2015</h3><h4>BUGS</h4><ul><li>500 error on <a href="http://docs.trakt.apiary.io/#reference/users/likes"><strong>/users/likes</strong></a> if an empty page was requested, now it correctly returns an empty array.</li><li>Added a use case for season level comments to the docs.</li><li>Suppress the initial error message that showed up on the OAuth sign in page.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>October 3, 2015</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/movies/boxoffice"><strong>/movies/boxoffice</strong></a> added to get the weekend box office top 10. Each result will include the <em>revenue</em>. <a href="https://plus.google.com/117775911806927899429/posts/TL1YgwqfJ65"><strong>(g+)</strong></a></li><li><a href="http://docs.trakt.apiary.io/#reference/movies/anticipated"><strong>/movies/anticipated</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/shows/anticipated"><strong>/shows/anticipated</strong></a> added to get the most anticipated movies or shows based on the number of lists an item appears on. <a href="https://plus.google.com/117775911806927899429/posts/TL1YgwqfJ65"><strong>(g+)</strong></a></li><li>Added the <em>status</em> for show search results. <a href="https://plus.google.com/+AnubhavRanjan/posts/4b67myPWkwJ"><strong>(g+)</strong></a></li><li><a href="http://docs.trakt.apiary.io/#reference/sync/remove-playback/remove-a-playback-item"><strong>/sync/playback/:id</strong></a> can remove individual playback progress items. <a href="https://plus.google.com/113434979435208258684/posts/QrfpZjLsv3E"><strong>(g+)</strong></a></li></ul><h4>BUGS</h4><ul><li>Fixed default comment sorting to display most recent first. <a href="https://plus.google.com/100382877254804059562/posts/JWnbVYb2LTA"><strong>(g+)</strong></a></li><li>Added <strong>planned</strong> as a valid show status in the docs. <a href="https://plus.google.com/117775911806927899429/posts/RQaRtmCtL1N"><strong>(g+)</strong></a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>September 29, 2015</h3><h4>BUGS</h4><ul><li>Fixed an issue where the trending count was incorrectly high due to an incorrect scrobbling implementation in some apps.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>September 5, 2015</h3><h4>UPDATES</h4><ul><li>New <a href="http://docs.trakt.apiary.io/#reference/users/list-comments/get-all-list-comments"><strong>/users/:id/lists/:list_id/comments</strong></a> method to return all comments on a user’s personal list. If the list doesn’t allow comments, the method will return an empty array.</li><li>All comments methods return HTTP headers with how many pages and items are in the results.</li></ul><pre>X-Pagination-Page-Count: 10<br>X-Pagination-Item-Count: 100</pre><h4>BUGS</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/seasons/comments/get-all-season-comments"><strong>Season</strong></a><strong> </strong>and <a href="http://docs.trakt.apiary.io/#reference/episodes/comments/get-all-episode-comments"><strong>episode</strong></a> comments correctly paginate.</li><li>Lists with people correctly return extended image info.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>August 31, 2015</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/shows/people"><strong>/shows/:id/people</strong></a> image will return the show specific headshot if available for an actor.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>August 24, 2015</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/movies/related/get-a-single-person"><strong>/people/:id</strong></a> returns fanart featuring this person.</li><li><a href="http://docs.trakt.apiary.io/#reference/sync/get-history/get-watched-history"><strong>/sync/history</strong></a><strong> </strong>and <a href="http://docs.trakt.apiary.io/#reference/users/history/get-watched-history"><strong>/users/:id/history</strong></a> return HTTP headers with how many pages and items are in the results.</li></ul><pre>X-Pagination-Page-Count: 10<br>X-Pagination-Item-Count: 100</pre><h4>BUGS</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/users/list-items/get-items-on-a-custom-list"><strong>/users/:id/lists/:list_id/items</strong></a> correctly returns based on the <em>extended</em> parameter.</li><li>User lists correctly updated the <em>updated_at</em> timestamp after re-ordering the items on the website.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>August 18, 2015</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/sync/add-to-history/add-items-to-watched-history"><strong>/sync/history</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/sync/add-to-collection/add-items-to-collection"><strong>/sync/collection</strong></a> accept a special string <strong><em>released</em></strong> for the watched_at and collected_at dates. This automatically uses the initial release date for the episode or movie.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>August 5, 2015</h3><h4>UPDATES</h4><ul><li>New methods added to help with TV show and movie discovery. Each method defaults to <em>weekly</em> data, but you can also specify <em>monthly</em> and <em>all </em>time periods. Each result contains stats relative to the time period too.<br><a href="http://docs.trakt.apiary.io/#reference/movies/played"><strong>/movies/played</strong></a><br><a href="http://docs.trakt.apiary.io/#reference/movies/watched"><strong>/movies/watched</strong></a><br><a href="http://docs.trakt.apiary.io/#reference/movies/collected"><strong>/movies/collected</strong></a><br><a href="http://docs.trakt.apiary.io/#reference/shows/played"><strong>/shows/played</strong></a><br><a href="http://docs.trakt.apiary.io/#reference/shows/watched"><strong>/shows/watched</strong></a><br><a href="http://docs.trakt.apiary.io/#reference/shows/collected"><strong>/shows/collected</strong></a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>July 24, 2015</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/users/likes/get-likes"><strong>/users/likes/lists</strong></a> returns a <em>user</em> object with the response.</li><li><a href="http://docs.trakt.apiary.io/#reference/users/history/get-watched-history"><strong>/users/:id/history</strong></a> updated so the filter type is optional. Each item in the response has new <em>id</em> and <em>type</em> values. You can also optionally filter the history results by a specific <em>id </em>and<em> type </em>to only get the history for that specific item.</li><li><a href="http://docs.trakt.apiary.io/#reference/sync/get-history/get-watched-history"><strong>/sync/history</strong></a> added as a clone of <a href="http://docs.trakt.apiary.io/#reference/users/history/get-watched-history"><strong>/users/:id/history</strong></a> but specific for the OAuth similar to the other sync methods.</li><li><a href="http://docs.trakt.apiary.io/#reference/sync/get-watchlist/get-watchlist"><strong>/sync/watchlist</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/users/watchlist/get-watchlist"><strong>/users/:id/watchlist</strong></a> now work without the <em>type</em> filter if you want a full list of everything.</li><li><a href="http://docs.trakt.apiary.io/#reference/sync/remove-from-history"><strong>/sync/history/remove</strong></a> supports removing individual watched history events by passing an array of <em>ids </em>as returned by <a href="http://docs.trakt.apiary.io/#reference/sync/get-history/get-watched-history"><strong>/sync/history</strong></a><strong>.</strong></li></ul><h4>BUGS</h4><ul><li>TV show banner images will fallback to TVDB if Fanart.tv doesn’t have one yet.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>June 26, 2015</h3><h4>BUGS</h4><ul><li>Calendar methods were adding 1 additional day of episodes in some cases.</li><li>Fixed 500 error on <a href="http://docs.trakt.apiary.io/#reference/users/watchlist/get-watchlist"><strong>/users/:id/watchlist</strong></a> for some users.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>June 18, 2015</h3><h4>UPDATES</h4><ul><li>Show progress methods <a href="http://docs.trakt.apiary.io/#reference/shows/watched-progress"><strong>/shows/progress/watched</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/shows/collection-progress"><strong>/shows/progress/collection</strong></a> will hide seasons by default if the user has hidden them on the website. An optional <em>hidden</em> flag can be set to still return the data.</li></ul><h4>BUGS</h4><ul><li>Liking lists had a bug preventing it from saving for a small subset of users.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>June 15, 2015</h3><h4>UPDATES</h4><ul><li>New <a href="http://docs.trakt.apiary.io/#reference/users/likes/get-comments"><strong>/users/likes</strong></a> method to get all comments and lists a user has liked. You can optionally filter for a specific type.</li><li>Update the progress methods to be in line with how the website calculates progress.</li><li>Show progress methods <a href="http://docs.trakt.apiary.io/#reference/shows/watched-progress"><strong>/shows/progress/watched</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/shows/collection-progress"><strong>/shows/progress/collection</strong></a> can optionally include special episodes now.</li><li><a href="http://docs.trakt.apiary.io/#reference/users/comments/get-comments"><strong>/users/:id/comments</strong></a><strong> </strong>and <a href="http://docs.trakt.apiary.io/#reference/users/likes/get-likes"><strong>/users/likes</strong></a> return HTTP headers with how many pages and items are in the results.</li></ul><pre>X-Pagination-Page-Count: 10<br>X-Pagination-Item-Count: 100</pre><h4>BUGS</h4><ul><li>Fixed 500 error for some users on <a href="http://docs.trakt.apiary.io/#reference/sync/playback/get-playback-progress"><strong>/sync/playback/episodes</strong></a>.</li><li>Improved username slug matching (substitute . with -).</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>May 27, 2015</h3><h4>UPDATES</h4><ul><li>Improved handling of <em>watchlisted_at</em> timestamps so they are only updated when needed.</li></ul><h4>BUGS</h4><ul><li>Checking in to or scrobbling an episode correctly removes the season from the watchlist if needed.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>May 22, 2015</h3><h4>BUGS</h4><ul><li>Updated movie, show, season, episode, and person objects to always return <em>null</em> for any blank ID.</li><li>Fixed 500 error occurring for some show collections.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>May 14, 2015</h3><h4>UPDATES</h4><ul><li>Added <em>vip_ep</em> flag to all base user objects. This indicates the user is an Executive Producer VIP member.</li></ul><h4>BUGS</h4><ul><li>Fixed <a href="http://docs.trakt.apiary.io/#reference/seasons/season/get-single-season-for-a-show"><strong>/shows/:id/seasons/:number</strong></a> for some shows that were not displaying the correct episode info.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>May 11, 2015</h3><h4>UPDATES</h4><ul><li>New <a href="http://docs.trakt.apiary.io/#reference/users/comments"><strong>/users/:id/comments</strong></a> method added to get all reviews and shouts a user has posted. You can also filter this by the type of item.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>April 24, 2015</h3><h4>UPDATES</h4><ul><li>Added <em>user_rating</em> to all comment methods so you can easily see what the user rated the item.</li><li>New <a href="http://docs.trakt.apiary.io/#reference/users/hidden-items"><strong>/users/hidden</strong></a> 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. <a href="https://plus.google.com/113434979435208258684/posts/4SCeSH6Ra7m"><strong>(g+)</strong></a></li></ul><h4>BUGS</h4><ul><li>Improved the check for invalid API keys.</li><li>Fixed CORS headers for the <strong>/oauth</strong> endpoints. <a href="https://plus.google.com/+DeanGardiner/posts/2o5sQd35CA7"><strong>(g+)</strong></a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>April 22, 2015</h3><h4>UPDATES</h4><ul><li>Comments automatically turn into reviews if 200 or more words, no need to figure that out in your app anymore.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>April 14, 2015</h3><h4>UPDATES</h4><ul><li>Added another caching server to speed up the API more.</li><li><a href="http://docs.trakt.apiary.io/#reference/movies/updates"><strong>/movies/updates</strong></a>, <a href="http://docs.trakt.apiary.io/#reference/shows/updates"><strong>/shows/updates</strong></a>, and <a href="http://docs.trakt.apiary.io/#reference/search"><strong>/search</strong></a> return HTTP headers with how many pages and items are in the results. <a href="https://plus.google.com/+DamienHaynes/posts/NEk3bJ49fFA"><strong>(g+)</strong></a></li></ul><pre>X-Pagination-Page-Count: 10<br>X-Pagination-Item-Count: 100</pre><h4>BUGS</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/movies/summary/get-a-movie"><strong>/movies/:id</strong></a> returns the <em>Last-Modified</em> header. <a href="https://plus.google.com/100620298106564947607/posts/hFTHRb42iez"><strong>(g+)</strong></a></li><li><a href="http://docs.trakt.apiary.io/#reference/users/history"><strong>/users/:id/history/episodes</strong></a> correctly applies pagination. <a href="https://plus.google.com/+FahimFarook/posts/JyyRxdfDzu1"><strong>(g+)</strong></a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>April 8, 2015</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/authentication-pin"><strong>PIN Authentication</strong></a> 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. <a href="https://plus.google.com/109991097847241028373/posts/dCvyQnUJ5Ea"><strong>(g+)</strong></a></li><li><a href="http://docs.trakt.apiary.io/#introduction/cors"><strong>CORS</strong></a> supported for client side apps. Specify your JavaScript origins in your app settings. <a href="https://plus.google.com/109991097847241028373/posts/TR1bdWZVR5T"><strong>(g+)</strong></a></li><li><a href="http://docs.trakt.apiary.io/#reference/shows/collection-progress/get-show-collection-progress"><strong>/shows/:id/progress/collection</strong></a> includes <em>last_collected_at</em> for the show, and <em>collected_at</em> for each episode.</li><li><a href="http://docs.trakt.apiary.io/#reference/shows/collection-progress/get-show-watched-progress"><strong>/shows/:id/progress/watched</strong></a> includes <em>last_watched_at</em> for the show and each episode.</li><li>Stats methods added for <a href="http://docs.trakt.apiary.io/#reference/movies/stats"><strong>movies</strong></a>, <a href="http://docs.trakt.apiary.io/#reference/shows/stats"><strong>shows</strong></a>, <a href="http://docs.trakt.apiary.io/#reference/seasons/stats"><strong>seasons</strong></a>, and <a href="http://docs.trakt.apiary.io/#reference/episodes/stats"><strong>episodes</strong></a>.</li><li>Enabled the <em>API Blueprint</em> button on the <a href="http://docs.trakt.apiary.io/"><strong>Trakt.tv API docs</strong></a> so you can learn how to beautifully document your API on <a href="http://apiary.io/"><strong>Apiary.io</strong></a>.</li></ul><h4>DEPRECATIONS</h4><ul><li>Token (media center) auth is deprecated. Existing apps will continue to work fine, but you should update to <a href="http://docs.trakt.apiary.io/#reference/authentication-pin"><strong>PIN Authentication</strong></a><strong> </strong>and use that moving forward.</li></ul><h4>BUGS</h4><ul><li>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. <a href="https://zapp.com)./">https://zapp.com).</a></li><li>Fixed a bug where brand new (and blank) accounts would incorrectly return episodes when viewing the personal calendar.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 26, 2015</h3><h4>UPDATES</h4><ul><li>New <a href="http://docs.trakt.apiary.io/#reference/calendars"><strong>/calendars</strong></a> methods! The new response is a linear list of episodes or movies, starting with the oldest. The <em>all</em> and <em>my</em> results have also been split apart for improved caching and ease of use.</li><li>More backend performance updates to help stabilize the servers.</li><li>Search results weight title matches better so they show up higher in the results.</li></ul><h4>DEPRECATIONS</h4><ul><li>The old <a href="http://docs.trakt.apiary.io/#reference/calendars"><strong>/calendars</strong></a> methods are now deprecated and undocumented, but will still continue working.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 23, 2015</h3><h4>UPDATES</h4><ul><li>Improved <a href="http://docs.trakt.apiary.io/#reference/sync/add-to-history"><strong>/sync/history</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/sync/add-to-collection"><strong>/sync/collection</strong></a> performance. This should significantly speed up these methods plus have a positive impact on general API performance. <a href="https://plus.google.com/109991097847241028373/posts/4aiewAPy7uD"><strong>(g+)</strong></a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 18, 2015</h3><h4>UPDATES</h4><ul><li>Canadian shows will use America/Toronto as the baseline time zone. This will improve the accuracy for shows and episodes on the <a href="http://docs.trakt.apiary.io/#reference/calendars"><strong>/calendars</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/shows/summary"><strong>/show/:id/summary</strong></a> with full extended info.</li><li>All OAuth pages force SSL.</li><li>Gender specific avatar placeholders. These are still piped through gravatar, but the default image will change if the user has a gender selected.</li><li>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.</li><li><a href="http://docs.trakt.apiary.io/#reference/users/settings/retrieve-settings"><strong>/users/settings</strong></a> returns a <em>account.time_24hr </em>boolean to indicate a preference for a 24 hour time format.</li><li><a href="http://docs.trakt.apiary.io/#reference/seasons/summary"><strong>/shows/:id/seasons</strong></a> can optionally return all episodes. <a href="https://plus.google.com/106170648901033549073/posts/Qm2oyvbzvUk"><strong>(g+)</strong></a></li></ul><h4>BUGS</h4><ul><li>Ignore <strong>x00</strong> episodes (sometime TVDB syncs these over, but generally they are specials that shouldn’t show up in the normal season).</li><li>Ignore duplicate episodes. This will clean up the season listings and the progress percentages.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>March 8, 2015</h3><h4>UPDATES</h4><ul><li>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 <em>checkin</em> or <em>scrobble</em> functionality. <a href="https://plus.google.com/109991097847241028373/posts/QVLbtQVXo6d"><strong>(g+)</strong></a></li></ul><h4>BUGS</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/sync/playback/get-playback-progress"><strong>/sync/playback</strong></a> correctly filters by episodes or movies.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>February 25, 2015</h3><h4>UPDATES</h4><ul><li><a href="http://docs.trakt.apiary.io/#reference/search/text-query/get-text-query-results"><strong>/search</strong></a> supports <em>year</em> filtering (only applies to movies and shows).</li><li><a href="http://docs.trakt.apiary.io/#reference/sync/playback"><strong>/sync/playback</strong></a> can be filtered by <em>type</em> and <em>limit.</em></li><li>Paginated methods will return HTTP headers for reference.</li></ul><pre>X-Pagination-Page: 1<br>X-Pagination-Limit: 10</pre><ul><li><a href="http://docs.trakt.apiary.io/#reference/movies/trending"><strong>/movies/trending</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/shows/trending"><strong>/shows/trending</strong></a> return HTTP headers with how many items are being watched and by how many users.</li></ul><pre>X-Pagination-Item-Count: 543<br>X-Trending-User-Count: 1721</pre><ul><li><em>comment_count</em> added to <a href="http://docs.trakt.apiary.io/#reference/users/lists"><strong>/users/:id/lists</strong></a><strong>.</strong> <a href="https://plus.google.com/102106311766146434747/posts/Y7kwrLnt2dP"><strong>(g+)</strong></a></li><li>Ensure <em>parent_id=0</em> for top level comments. <a href="https://plus.google.com/102106311766146434747/posts/c2WB66GoySi"><strong>(g+)</strong></a></li><li>Get up to 100 items for <a href="http://docs.trakt.apiary.io/#reference/movies/related"><strong>/movies/:id/related</strong></a> and <a href="http://docs.trakt.apiary.io/#reference/shows/related"><strong>/shows/:id/related</strong></a><strong>.</strong> <a href="https://plus.google.com/102106311766146434747/posts/WdW7jndrdQV"><strong>(g+)</strong></a></li><li>Ratings distribution added to <a href="http://docs.trakt.apiary.io/#reference/users/stats"><strong>/users/:id/stats</strong></a><strong>.</strong> <a href="https://plus.google.com/102106311766146434747/posts/QNE5GmzgeKm"><strong>(g+)</strong></a></li><li><em>aired_episodes </em>count<em> </em>added to full season info. <a href="https://plus.google.com/102106311766146434747/posts/DFmLBJc6z6h"><strong>(g+)</strong></a></li></ul><h4>BUGS</h4><ul><li>Formatted UTC date for <a href="http://docs.trakt.apiary.io/#reference/shows/popular"><strong>/shows/popular?extended=full</strong></a><strong>. </strong><a href="https://plus.google.com/112739218731739489705/posts/3NxRWfWQGUk"><strong>(g+)</strong></a></li><li>Adding a single bad item to a custom list. <a href="https://plus.google.com/104231013287940355148/posts/iwiATvfBgTi">(<strong>g+)</strong></a></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>February 20, 2015</h3><h4>BUGS</h4><ul><li>Added <strong>api-v2launch.trakt.tv</strong> as an allowed domain for Google login. However, you should use <strong>trakt.tv</strong> for all OAuth page URLs. <a href="https://plus.google.com/104231013287940355148/posts/ie6azdmokLx"><strong>(g+)</strong></a></li><li>Fixed 500 error for <a href="http://docs.trakt.apiary.io/#reference/users/watching"><strong>/users/:id/watching</strong></a><strong>.</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*2uwsNeWN8lBfA66xqaOHoA.png" /></figure><h3>December 29, 2014</h3><h4>UPDATES</h4><ul><li><a href="https://medium.com/@trakt/announcing-trakt-tv-2-0-83179ce1eda0"><strong>Trakt.tv 2.0 launched!</strong></a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9f4041819718" width="1" height="1" alt=""><hr><p><a href="https://medium.com/api-news/api-changelog-9f4041819718">API Changelog</a> was originally published in <a href="https://medium.com/api-news">Trakt API Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>