actionGETv1.0.0
Get a comment or reply
#### 😁 Emojis Returns a single comment and indicates how many replies it has. Use [**/comments/:id/replies**](/reference/comments/replies/) to get the actual replies.
actionGETv1.0.0
Get a movie
#### ✨ Extended Info Returns a single movie's details. **Note:** When getting `full` extended info, the `status` field can have a value of `released`, `in production`, `post production`, `planned`, `rumored`, or `canceled`.
actionGETv1.0.0
Get a single episode for a show
#### ✨ Extended Info Returns a single episode's details. All date and times are in UTC and were calculated using the episode's `air_date` and show's `country` and `air_time`. **Note:** If the `first_aired` is unknown, it will be set to `null`.
actionGETv1.0.0
Get a single person
#### ✨ Extended Info Returns a single person's details. #### Gender If available, the `gender` property will be set to `male`, `female`, or `non_binary`. #### Known For Department If available, the `known_for_department` property will be set to `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, or `editing`. Many people have credits across departments, `known_for` allows you to select their default credits more accurately.
actionGETv1.0.0
Get a single show
#### ✨ Extended Info Returns a single shows's details. If you request extended info, the `airs` object is relative to the show's country. You can use the `day`, `time`, and `timezone` to construct your own date then convert it to whatever timezone your user is in. **Note:** When getting `full` extended info, the `status` field can have a value of `returning series` (airing right now), `continuing` (airing right now), `in production` (airing soon), `planned` (in development), `upcoming` (in development), `pilot`, `canceled`, or `ended`.
actionGETv1.0.0
Get a user's personal lists
#### 🔓 OAuth Optional 😁 Emojis Returns all personal lists for a user. Use the [**/users/:id/lists/:list_id/items**](#reference/users/list-items) method to get the actual items a specific list contains.
actionGETv1.0.0
Get all list comments
#### 📄 Pagination 😁 Emojis Returns all top level comments for a list. By default, the `newest` comments are returned first. Other sorting options include `oldest`, most `likes`, and most `replies`.
actionGETv1.0.0
Get all lists a user can collaborate on
#### 🔓 OAuth Optional Returns all lists a user can collaborate on. This gives full access to add, remove, and re-order list items. It essentially works just like a list owned by the user, just make sure to use the correct list owner `user` when building the API URLs.
actionGETv1.0.0
Get all movie aliases
Returns all title aliases for a movie. Includes country where name is different.
actionGETv1.0.0
Get all movie comments
#### 📄 Pagination 😁 Emojis Returns all top level comments for a movie. By default, the `newest` comments are returned first. Other sorting options include `oldest`, most `likes`, most `replies`, `highest` rated, `lowest` rated, and most `plays`.
actionGETv1.0.0
Get all movie releases
Returns all releases for a movie including country, certification, release date, release type, and note. The release type can be set to `unknown`, `premiere`, `limited`, `theatrical`, `digital`, `physical`, or `tv`. The `note` might have optional info such as the film festival name for a `premiere` release or Blu-ray specs for a `physical` release. We pull this info from [TMDB](https://developers.themoviedb.org/3/movies/get-movie-release-dates).
actionGETv1.0.0
Get all movie translations
Returns all translations for a movie, including language and translated values for title, tagline and overview.
actionGETv1.0.0
Get all people for a movie
#### ✨ Extended Info Returns all `cast` and `crew` for a movie. Each `cast` member will have a `characters` array and a standard `person` object. The `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, and `editing` (if there are people for those crew positions). Each of those members will have a `jobs` array and a standard `person` object.
actionGETv1.0.0
Get all people for a season
#### ✨ Extended Info Returns all `cast` and `crew` for a season, including the `episode_count` for which they appear. Each `cast` member will have a `characters` array and a standard `person` object. The `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, and `editing` (if there are people for those crew positions).. Each of those members will have a `jobs` array and a standard `person` object. #### Guest Stars If you add `?extended=guest_stars` to the URL, it will return all guest stars that appeared in at least 1 episode of the season. **Note:** This returns a lot of data, so please only use this extended parameter if you actually need it!
actionGETv1.0.0
Get all people for a show
#### ✨ Extended Info Returns all `cast` and `crew` for a show, including the `episode_count` for which they appears. Each `cast` member will have a `characters` array and a standard `person` object. The `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, `editing`, and `created by` (if there are people for those crew positions). Each of those members will have a `jobs` array and a standard `person` object. #### Guest Stars If you add `?extended=guest_stars` to the URL, it will return all guest stars that appeared in at least 1 episode of the show. **Note:** This returns a lot of data, so please only use this extended parameter if you actually need it!
actionGETv1.0.0
Get all people for an episode
#### ✨ Extended Info Returns all `cast` and `crew` for an episode. Each `cast` member will have a `characters` array and a standard `person` object. The `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, and `editing` (if there are people for those crew positions). Each of those members will have a `jobs` array and a standard `person` object. #### Guest Stars If you add `?extended=guest_stars` to the URL, it will return all guest stars that appeared in the episode. **Note:** This returns a lot of data, so please only use this extended parameter if you actually need it!
actionGETv1.0.0
Get all season comments
#### 📄 Pagination 😁 Emojis Returns all top level comments for a season. By default, the `newest` comments are returned first. Other sorting options include `oldest`, most `likes`, most `replies`, `highest` rated, `lowest` rated, most `plays`, and highest `watched` percentage.
actionGETv1.0.0
Get all season translations
Returns all translations for an season, including language and translated values for title and overview.
actionGETv1.0.0
Get all seasons for a show
#### ✨ Extended Info Returns all seasons for a show including the number of episodes in each season. #### Episodes If you add `?extended=episodes` to the URL, it will return all episodes for all seasons. **Note:** This returns a lot of data, so please only use this extended parameter if you actually need it!
actionGETv1.0.0
Get all show aliases
Returns all title aliases for a show. Includes country where name is different.
actionGETv1.0.0
Get all show certifications
Returns all content certifications for a show, including the country.
actionGETv1.0.0
Get all show comments
#### 📄 Pagination 😁 Emojis Returns all top level comments for a show. By default, the `newest` comments are returned first. Other sorting options include `oldest`, most `likes`, most `replies`, `highest` rated, `lowest` rated, most `plays`, and highest `watched` percentage.
actionGETv1.0.0
Get all show translations
Returns all translations for a show, including language and translated values for title and overview.
actionGETv1.0.0
Get all users who liked a comment
#### 📄 Pagination Returns all users who liked a comment. If you only need the `replies` count, the main `comment` object already has that, so no need to use this method.
actionGETv1.0.0
Get all users who liked a list
#### 📄 Pagination Returns all users who liked a list.
actionGETv1.0.0
Get certifications
Get a list of all certifications, including names, slugs, and descriptions.
actionGETv1.0.0
Get collection
#### 🔒 OAuth Required ✨ Extended Info Get all collected items in a user's collection. A collected item indicates availability to watch digitally or on physical media. 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_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. Each `show` object contains `last_collected_at` and `last_updated_at` timestamps. Since users can set custom dates when they collected episodes, it is possible for `last_collected_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 show if you see a newer timestamp. If you add `?extended=metadata` to the URL, it will return the additional `media_type`, `resolution`, `hdr`, `audio`, `audio_channels` and '3d' metadata. It will use `null` if the metadata isn't set for an item.
actionGETv1.0.0
Get countries
Get a list of all countries, including names and codes.
actionGETv1.0.0
Get DVD releases
#### ✨ Extended Info 🎚 Filters Returns all movies with a DVD release date during the time period specified.
actionGETv1.0.0
Get DVD releases
#### 🔒 OAuth Required ✨ Extended Info 🎚 Filters Returns all movies with a DVD release date during the time period specified.
actionGETv1.0.0
Get episode ratings
Returns rating (between 0 and 10) and distribution for an episode.
actionGETv1.0.0
Get episode stats
Returns lots of episode stats.
actionGETv1.0.0
Get follow requests
#### 🔒 OAuth Required ✨ Extended Info List a user's pending follow requests so they can either approve or deny them.
actionGETv1.0.0
Get followers
#### 🔓 OAuth Optional ✨ Extended Info Returns all followers including when the relationship began.
actionGETv1.0.0
Get following
#### 🔓 OAuth Optional ✨ Extended Info Returns all user's they follow including when the relationship began.
actionGETv1.0.0
Get friends
#### 🔓 OAuth Optional ✨ Extended Info Returns all friends for a user including when the relationship began. Friendship is a 2 way relationship where each user follows the other.
actionGETv1.0.0
Get genres
Get a list of all genres, including names and slugs.
actionGETv1.0.0
Get hidden items
#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info Get hidden items for a section. This will return an array of standard media objects. You can optionally limit the `type` of results to return.
actionGETv1.0.0
Get ID lookup results
#### 📄 Pagination ✨ Extended Info Lookup items by their Trakt, IMDB, TMDB, or TVDB ID. If you use the search url without a `type` it might return multiple items if the `id_type` is not globally unique. Specify the `type` of results by sending a single value or a comma delimited string for multiple types. | Type | URL | |---|---| | `trakt` | `/search/trakt/:id` | | | `/search/trakt/:id?type=movie` | | | `/search/trakt/:id?type=show` | | | `/search/trakt/:id?type=episode` | | | `/search/trakt/:id?type=person` | | `imdb` | `/search/imdb/:id` | | `tmdb` | `/search/tmdb/:id` | | | `/search/tmdb/:id?type=movie` | | | `/search/tmdb/:id?type=show` | | | `/search/tmdb/:id?type=episode` | | | `/search/tmdb/:id?type=person` | | `tvdb` | `/search/tvdb/:id` | | | `/search/tvdb/:id?type=show` | | | `/search/tvdb/:id?type=episode` |
actionGETv1.0.0
Get items on a list
#### 📄 Pagination Optional ✨ Extended Info 😁 Emojis Get all items on a personal list. Items can be a `movie`, `show`, `season`, `episode`, or `person`. You can optionally specify the `type` parameter with a single value or comma delimited string for multiple item types. #### Notes Each list item contains a `notes` field with text entered by the user. #### Sorting Headers All list items are sorted by ascending `rank`. We also send `X-Sort-By` and `X-Sort-How` headers which can be used to custom sort the list _**in your app**_ based on the user's preference. Values for `X-Sort-By` include `rank`, `added`, `title`, `released`, `runtime`, `popularity`, `percentage`, `votes`, `my_rating`, `random`, `watched`, and `collected`. Values for `X-Sort-How` include `asc` and `desc`.
actionGETv1.0.0
Get items on a personal list
#### 🔓 OAuth Optional 📄 Pagination Optional ✨ Extended Info 😁 Emojis Get all items on a personal list. Items can be a `movie`, `show`, `season`, `episode`, or `person`. You can optionally specify the `type` parameter with a single value or comma delimited string for multiple item types. #### Notes Each list item contains a `notes` field with text entered by the user. #### Sorting Headers All list items are sorted by ascending `rank`. We also send `X-Sort-By` and `X-Sort-How` headers which can be used to custom sort the list _**in your app**_ based on the user's preference. Values for `X-Sort-By` include `rank`, `added`, `title`, `released`, `runtime`, `popularity`, `percentage`, `votes`, `my_rating`, `random`, `watched`, and `collected`. Values for `X-Sort-How` include `asc` and `desc`.
actionGETv1.0.0
Get languages
Get a list of all langauges, including names and codes.
actionGETv1.0.0
Get last activity
#### 🔒 OAuth Required This method is a useful first step in the syncing process. We recommended caching these dates locally, then you can compare to know exactly what data has changed recently. This can greatly optimize your syncs so you don't pull down a ton of data only to see nothing has actually changed. #### Account `settings_at` is set when the OAuth user updates any of their Trakt settings on the website. `followed_at` is set when another Trakt user follows or unfollows the OAuth user. `following_at` is set when the OAuth user follows or unfollows another Trakt user. `pending_at` is set when the OAuth user follows a private account, which requires their approval. `requested_at` is set when the OAuth user has a private account and someone requests to follow them.
actionGETv1.0.0
Get last episode
#### ✨ Extended Info Returns the most recently aired episode. If no episode is found, a `204` HTTP status code will be returned.
actionGETv1.0.0
Get likes
#### 🔒 OAuth Optional 📄 Pagination Get items a user likes. This will return an array of standard media objects. You can optionally limit the `type` of results to return. #### Comment Media Objects If you add `?extended=comments` to the URL, it will return media objects for each comment like. **Note:** This returns a lot of data, so please only use this extended parameter if you actually need it!
actionGETv1.0.0
Get list
#### 😁 Emojis Returns a single list. Use the [**/lists/:id/items**](#reference/lists/list-items) method to get the actual items this list contains. **Note:** You must use an integer `id`, and only public lists will return data.
actionGETv1.0.0
Get lists containing this movie
#### 📄 Pagination 😁 Emojis Returns all lists that contain this movie. By default, `personal` lists are returned sorted by the most `popular`.
actionGETv1.0.0
Get lists containing this person
#### 📄 Pagination 😁 Emojis Returns all lists that contain this person. By default, `personal` lists are returned sorted by the most `popular`.
actionGETv1.0.0
Get lists containing this show
#### 📄 Pagination 😁 Emojis Returns all lists that contain this show. By default, `personal` lists are returned sorted by the most `popular`.
actionGETv1.0.0
Get movie credits
#### ✨ Extended Info Returns all movies where this person is in the `cast` or `crew`. Each `cast` object will have a `characters` array and a standard `movie` object. The `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, and `editing` (if there are people for those crew positions). Each of those members will have a `jobs` array and a standard `movie` object.
actionGETv1.0.0
Get movie ratings
Returns rating (between 0 and 10) and distribution for a movie.
actionGETv1.0.0
Get movie recommendations
#### 🔒 OAuth Required ✨ Extended Info Movie recommendations for a user. By default, `10` results are returned. You can send a `limit` to get up to `100` results per page. Set `ignore_collected=true` to filter out movies the user has already collected or `ignore_watchlisted=true` to filter out movies the user has already watchlisted.
actionGETv1.0.0
Get movie stats
Returns lots of movie stats.
actionGETv1.0.0
Get movie studios
Returns all studios for a movie.
actionGETv1.0.0
Get movies
#### ✨ Extended Info 🎚 Filters Returns all movies with a release date during the time period specified.
actionGETv1.0.0
Get movies
#### 🔒 OAuth Required ✨ Extended Info 🎚 Filters Returns all movies with a release date during the time period specified.
actionGETv1.0.0
Get networks
Get a list of all TV networks, including the name.
actionGETv1.0.0
Get new shows
#### ✨ Extended Info 🎚 Filters Returns all new show premieres (season 1, episode 1) airing during the time period specified.
actionGETv1.0.0
Get new shows
#### 🔒 OAuth Required ✨ Extended Info 🎚 Filters Returns all new show premieres (season 1, episode 1) airing during the time period specified.
actionGETv1.0.0
Get next episode
#### ✨ Extended Info Returns the next scheduled to air episode. If no episode is found, a `204` HTTP status code will be returned.
actionGETv1.0.0
Get pending following requests
#### 🔒 OAuth Required ✨ Extended Info List a user's pending following requests that they're waiting for the other user's to approve.
actionGETv1.0.0
Get personal list
#### 🔓 OAuth Optional 😁 Emojis Returns a single personal list. Use the [**/users/:id/lists/:list_id/items**](#reference/users/list-items) method to get the actual items this list contains.
actionGETv1.0.0
Get personal recommendations
#### 🔒 OAuth Required 📄 Pagination Optional ✨ Extended Info 😁 Emojis If the user only had 50 movies and TV shows to bring with them on a desert island, what would they be? These recommendations are used to enchance Trakt's social recommendation algorithm. Apps should encourage user's to build their personal recommendations so the algorithm keeps getting better. #### Notes Each recommendation contains a `notes` field explaining why the user recommended the item.
actionGETv1.0.0
Get playback progress
#### 🔒 OAuth Required 📄 Pagination Optional Whenever a scrobble is paused, the playback progress is saved. Use this progress to sync up playback across different media centers or apps. For example, you can start watching a movie in a media center, stop it, then resume on your tablet from the same spot. Each item will have the `progress` percentage between 0 and 100. You can optionally specify a `type` to only get `movies` or `episodes`. By default, all results will be returned. Pagination is optional and can be used for something like an "on deck" feature, or if you only need a limited data set. **Note:** We only save playback progress for the last 6 months.
actionGETv1.0.0
Get popular lists
#### 📄 Pagination 😁 Emojis Returns the most popular lists. Popularity is calculated using total number of likes and comments.
actionGETv1.0.0
Get popular movies
#### 📄 Pagination ✨ Extended Info 🎚 Filters Returns the most popular movies. Popularity is calculated using the rating percentage and the number of ratings.
actionGETv1.0.0
Get popular shows
#### 📄 Pagination ✨ Extended Info 🎚 Filters Returns the most popular shows. Popularity is calculated using the rating percentage and the number of ratings.
actionGETv1.0.0
Get ratings
#### 🔒 OAuth Required 📄 Pagination Optional ✨ Extended Info Get a user's ratings filtered by `type`. You can optionally filter for a specific `rating` between 1 and 10. Send a comma separated string for `rating` if you need multiple ratings.
actionGETv1.0.0
Get recently created comments
#### 📄 Pagination ✨ Extended Info 😁 Emojis Returns the most recently written comments across all of Trakt. You can optionally filter by the `comment_type` and media `type` to limit what gets returned. If you want to `include_replies` that will return replies in place alongside top level comments.
actionGETv1.0.0
Get recently updated comments
#### 📄 Pagination ✨ Extended Info 😁 Emojis Returns the most recently updated comments across all of Trakt. You can optionally filter by the `comment_type` and media `type` to limit what gets returned. If you want to `include_replies` that will return replies in place alongside top level comments.
actionGETv1.0.0
Get recently updated movie Trakt IDs
#### 📄 Pagination Returns all movie Trakt IDs updated since the specified UTC date and time. We recommended storing the `X-Start-Date` header you can be efficient using this method moving forward. By default, `10` results are returned. You can send a `limit` to get up to `100` results per page. **Important!** The `start_date` is only accurate to the hour, for caching purposes. Please drop the minutes and seconds from your timestamp to help optimize our cached data. For example, use `2021-07-17T12:00:00Z` and not `2021-07-17T12:23:34Z`. **Note:** The `start_date` can only be a maximum of 30 days in the past.
actionGETv1.0.0
Get recently updated movies
#### 📄 Pagination ✨ Extended Info Returns all movies updated since the specified UTC date and time. We recommended storing the `X-Start-Date` header you can be efficient using this method moving forward. By default, `10` results are returned. You can send a `limit` to get up to `100` results per page. **Important!** The `start_date` is only accurate to the hour, for caching purposes. Please drop the minutes and seconds from your timestamp to help optimize our cached data. For example, use `2021-07-17T12:00:00Z` and not `2021-07-17T12:23:34Z`. **Note:** The `start_date` can only be a maximum of 30 days in the past.
actionGETv1.0.0
Get recently updated people
#### 📄 Pagination ✨ Extended Info Returns all people updated since the specified UTC date and time. We recommended storing the `X-Start-Date` header you can be efficient using this method moving forward. By default, `10` results are returned. You can send a `limit` to get up to `100` results per page. **Important!** The `start_date` is only accurate to the hour, for caching purposes. Please drop the minutes and seconds from your timestamp to help optimize our cached data. For example, use `2021-07-17T12:00:00Z` and not `2021-07-17T12:23:34Z`. **Note:** The `start_date` can only be a maximum of 30 days in the past.
actionGETv1.0.0
Get recently updated people Trakt IDs
#### 📄 Pagination Returns all people Trakt IDs updated since the specified UTC date and time. We recommended storing the `X-Start-Date` header you can be efficient using this method moving forward. By default, `10` results are returned. You can send a `limit` to get up to `100` results per page. **Important!** The `start_date` is only accurate to the hour, for caching purposes. Please drop the minutes and seconds from your timestamp to help optimize our cached data. For example, use `2021-07-17T12:00:00Z` and not `2021-07-17T12:23:34Z`. **Note:** The `start_date` can only be a maximum of 30 days in the past.
actionGETv1.0.0
Get recently updated show Trakt IDs
#### 📄 Pagination Returns all show Trakt IDs updated since the specified UTC date and time. We recommended storing the `X-Start-Date` header you can be efficient using this method moving forward. By default, `10` results are returned. You can send a `limit` to get up to `100` results per page. **Important!** The `start_date` is only accurate to the hour, for caching purposes. Please drop the minutes and seconds from your timestamp to help optimize our cached data. For example, use `2021-07-17T12:00:00Z` and not `2021-07-17T12:23:34Z`. **Note:** The `start_date` can only be a maximum of 30 days in the past.
actionGETv1.0.0
Get recently updated shows
#### 📄 Pagination ✨ Extended Info Returns all shows updated since the specified UTC date and time. We recommended storing the `X-Start-Date` header you can be efficient using this method moving forward. By default, `10` results are returned. You can send a `limit` to get up to `100` results per page. **Important!** The `start_date` is only accurate to the hour, for caching purposes. Please drop the minutes and seconds from your timestamp to help optimize our cached data. For example, use `2021-07-17T12:00:00Z` and not `2021-07-17T12:23:34Z`. **Note:** The `start_date` can only be a maximum of 30 days in the past.
actionGETv1.0.0
Get related movies
#### 📄 Pagination ✨ Extended Info Returns related and similar movies.
actionGETv1.0.0
Get related shows
#### 📄 Pagination ✨ Extended Info Returns related and similar shows.
actionGETv1.0.0
Get replies for a comment
#### 📄 Pagination 😁 Emojis Returns all replies for a comment. It is possible these replies could have replies themselves, so in that case you would just call [**/comments/:id/replies**](/reference/comments/replies/) again with the new comment `id`.
actionGETv1.0.0
Get saved filters
#### 🔒 OAuth Required 📄 Pagination 🔥 VIP Only Get all saved filters a user has created. The `path` and `query` can be used to construct an API path to retrieve the saved data. Think of this like a dynamically updated list.
actionGETv1.0.0
Get season premieres
#### ✨ Extended Info 🎚 Filters Returns all show premieres (any season, episode 1) airing during the time period specified.
actionGETv1.0.0
Get season premieres
#### 🔒 OAuth Required ✨ Extended Info 🎚 Filters Returns all show premieres (any season, episode 1) airing during the time period specified.
actionGETv1.0.0
Get season ratings
Returns rating (between 0 and 10) and distribution for a season.
actionGETv1.0.0
Get season stats
Returns lots of season stats.
actionGETv1.0.0
Get show credits
#### ✨ Extended Info Returns all shows where this person is in the `cast` or `crew`, including the `episode_count` for which they appear. Each `cast` object will have a `characters` array and a standard `show` object. If `series_regular` is `true`, this person is a series regular and not simply a guest star. The `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, `editing`, and `created by` (if there are people for those crew positions). Each of those members will have a `jobs` array and a standard `show` object.
actionGETv1.0.0
Get show ratings
Returns rating (between 0 and 10) and distribution for a show.
actionGETv1.0.0
Get show recommendations
#### 🔒 OAuth Required ✨ Extended Info TV show recommendations for a user. By default, `10` results are returned. You can send a `limit` to get up to `100` results per page. Set `ignore_collected=true` to filter out shows the user has already collected or `ignore_watchlisted=true` to filter out shows the user has already watchlisted.
actionGETv1.0.0
Get show stats
Returns lots of show stats.
actionGETv1.0.0
Get show studios
Returns all studios for a show.
actionGETv1.0.0
Get shows
#### ✨ Extended Info 🎚 Filters Returns all shows airing during the time period specified.
actionGETv1.0.0
Get shows
#### 🔒 OAuth Required ✨ Extended Info 🎚 Filters Returns all shows airing during the time period specified.
actionGETv1.0.0
Get single season for a show
#### ✨ Extended Info Returns all episodes for a specific season of a show. #### Translations If you'd like to included translated episode titles and overviews in the response, include the `translations` parameter in the URL. Include all languages by setting the parameter to `all` or use a specific 2 digit country language code to further limit it. **Note:** This returns a lot of data, so please only use this parameter if you actually need it!
actionGETv1.0.0
Get stats
#### 🔓 OAuth Optional Returns stats about the movies, shows, and episodes a user has watched, collected, and rated.
actionGETv1.0.0
Get text query results
#### 📄 Pagination ✨ Extended Info 🎚 Filters Search all text fields that a media object contains (i.e. title, overview, etc). Results are ordered by the most relevant score. Specify the `type` of results by sending a single value or a comma delimited string for multiple types. #### Special Characters Our search engine (Solr) gives the following characters special meaning when they appear in a query: `+ - && || ! ( ) { } [ ] ^ " ~ * ? : /` To interpret any of these characters literally (and not as a special character), precede the character with a backslash `\` character. #### Search Fields By default, all text fields are used to search for the `query`. You can optionally specify the `fields` parameter with a single value or comma delimited string for multiple fields. Each `type` has specific `fields` that can be specified. This can be useful if you want to support more strict searches (i.e. title only). | Type | Field | |---|---| | `movie` | `title` | | | `tagline` | | | `overview` | | | `people` | | | `translations` | | | `aliases` | | `show` | `title` | | | `overview` | | | `people` | | | `translations` | | | `aliases` | | `episode` | `title` | | | `overview` | | `person` | `name` | | | `biography` | | `list` | `name` | | | `description` |
actionGETv1.0.0
Get the attached media item
#### ✨ Extended Info Returns the media item this comment is attached to. The media type can be `movie`, `show`, `season`, `episode`, or `list` and it also returns the standard media object for that media type.
actionGETv1.0.0
Get the most anticipated movies
#### 📄 Pagination ✨ Extended Info 🎚 Filters Returns the most anticipated movies based on the number of lists a movie appears on.
actionGETv1.0.0
Get the most anticipated shows
#### 📄 Pagination ✨ Extended Info 🎚 Filters Returns the most anticipated shows based on the number of lists a show appears on.
actionGETv1.0.0
Get users watching right now
#### ✨ Extended Info Returns all users watching this episode right now.
actionGETv1.0.0
Get users watching right now
#### ✨ Extended Info Returns all users watching this season right now.
actionGETv1.0.0
Get users watching right now
#### ✨ Extended Info Returns all users watching this show right now.
Beyond the catalog
Any provider, on request.
01
Request it
Tell us which provider you need, and we will ship it in the registry.
02
Generate it
Point swirls add at an OpenAPI or GraphQL spec. Typed actions for any API you hold credentials for, today.
acme · integrations
terminal
~/acme $swirls add linear
✓ 12 typed actions · scopes and schemas included
~/acme $swirls add https://api.acme.dev/openapi.json
◆ Fetched spec · 38 operations
✓ 6 typed actions · generated from spec