Trakt

Trakt Lists API

Trending, popular, and personal lists.

Documentation GitHub OpenAPI

Documentation

https://trakt.docs.apiary.io/

https://trakt.docs.apiary.io/#reference/authentication-oauth

https://trakt.docs.apiary.io/

Specifications

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/openapi/trakt-lists-api-openapi.yml

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/json-schema/trakt-movie-schema.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/json-schema/trakt-show-schema.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/json-schema/trakt-episode-schema.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/json-schema/trakt-user-schema.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/json-schema/trakt-scrobble-schema.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/json-structure/trakt-movie-structure.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/json-structure/trakt-show-structure.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/json-structure/trakt-history-structure.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/examples/trakt-getTrendingMovies-example.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/examples/trakt-getMovie-example.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/examples/trakt-generateDeviceCode-example.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/examples/trakt-pollDeviceToken-example.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/examples/trakt-scrobbleStart-example.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/examples/trakt-addToHistory-example.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/examples/trakt-searchText-example.json

https://raw.githubusercontent.com/api-evangelist/trakt/refs/heads/main/examples/trakt-getShowWatchedProgress-example.json

OpenAPI Specification

openapi: 3.0.3
info:
  title: Trakt Calendars Lists API
  description: 'The Trakt API is a RESTful API for integrating TV show and movie tracking

    features into applications. It exposes Trakt''s media database, user

    watch history, lists, watchlists, ratings, comments, scrobbling, and

    recommendations. Authentication is OAuth 2.0 (Authorization Code and

    Device flows).


    This OpenAPI is a representative sampling of the full Trakt API v2

    surface, covering authentication, movies, shows, episodes, seasons,

    people, search, users, sync, scrobble, checkin, lists, calendars,

    recommendations, comments, notes, and reference data. The canonical

    contract is the ts-rest router published at github.com/trakt/trakt-api.

    '
  version: '2.0'
  contact:
    name: Trakt API Support
    url: https://forums.trakt.tv
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
- url: https://api.trakt.tv
  description: Production
- url: https://api-staging.trakt.tv
  description: Staging
security:
- bearerAuth: []
tags:
- name: Lists
  description: Trending, popular, and personal lists.
paths:
  /lists/trending:
    get:
      tags:
      - Lists
      operationId: getTrendingLists
      summary: Get Trending Lists
      responses:
        '200':
          description: Trending lists.
  /lists/popular:
    get:
      tags:
      - Lists
      operationId: getPopularLists
      summary: Get Popular Lists
      responses:
        '200':
          description: Popular lists.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: OAuth 2.0 access token from /oauth/token or /oauth/device/token. Send via Authorization header and required headers trakt-api-version (2) and trakt-api-key (client_id).