Astro Trakt.tv loader

This package provides a Trakt.tv content loader for Astro's content layer. The content loaders correspond to specific Trakt API endpoints.

Want to see an overview of all my loaders? Visit astro-loaders.lekoarts.de ✨

Prerequisites

• Astro 5 or later installed
• A Trakt.tv API key
  • Go to your Trakt Applications page and create a new application. The Client ID is your API key.

Installation

# npm
npm install @lekoarts/trakt-loader

# yarn
yarn add @lekoarts/trakt-loader

# pnpm
pnpm install @lekoarts/trakt-loader

Usage

Import @lekoarts/trakt-loader into src/content.config.ts and define your collections. You can import various loaders that correspond to their respective Trakt API endpoints.

Important: You need to either define the Trakt API key as an environment variable (TRAKT_API_KEY) or pass it as the api_key option.

traktUsersListsLoader

Returns all personal lists for a user.

Required options

• id (string): The Trakt username or slug.

Usage

import { traktUsersListsLoader } from '@lekoarts/trakt-loader'

const usersLists = defineCollection({
  loader: traktUsersListsLoader({
    id: 'trakt-username',
  }),
})

traktUsersRatingsLoader

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.

Required options

• id (string): The Trakt username or slug.
• type (string): One of movies, shows, seasons, episodes, or all.

Optional options

• rating (string): Filter for a specific rating (1-10 or comma-separated).
• extended (string | string[]): Request additional fields.

Usage

Fetching all movie ratings for a user:

import { traktUsersRatingsLoader } from '@lekoarts/trakt-loader'

const usersRatings = defineCollection({
  loader: traktUsersRatingsLoader({
    id: 'trakt-username',
    type: 'movies',
  }),
})

Fetching only 10-star show ratings with extended info:

import { traktUsersRatingsLoader } from '@lekoarts/trakt-loader'

const usersRatings = defineCollection({
  loader: traktUsersRatingsLoader({
    id: 'trakt-username',
    type: 'shows',
    rating: 10,
    extended: ['full'],
  }),
})

traktUsersStatsLoader

Returns stats about the movies, shows, and episodes a user has watched, collected, and rated.

Required options

• id (string): The Trakt username or slug.

Usage

import { traktUsersStatsLoader } from '@lekoarts/trakt-loader'

const usersStats = defineCollection({
  loader: traktUsersStatsLoader({
    id: 'trakt-username',
  }),
})

traktUsersWatchedLoader

Returns all movies or shows a user has watched sorted by most plays.

Required options

• id (string): The Trakt username or slug.
• type (string): Either movies or shows.

Optional options

• extended (string | string[]): Request additional fields.

Usage

Fetching all watched movies:

import { traktUsersWatchedLoader } from '@lekoarts/trakt-loader'

const usersWatched = defineCollection({
  loader: traktUsersWatchedLoader({
    id: 'trakt-username',
    type: 'movies',
  }),
})

Fetching all watched shows with extended info:

import { traktUsersWatchedLoader } from '@lekoarts/trakt-loader'

const usersWatched = defineCollection({
  loader: traktUsersWatchedLoader({
    id: 'trakt-username',
    type: 'shows',
    extended: ['full'],
  }),
})

traktUsersHistoryLoader

Returns movies and episodes that a user has watched, sorted by most recent. You can optionally limit the type to movies or episodes.

Required options

• id (string): The Trakt username or slug.
• type (string): One of movies, shows, seasons, or episodes.

Optional options

• item_id (number): Trakt ID for a specific item to limit the history.
• start_at (string): Starting date for the history.
• end_at (string): Ending date for the history.
• extended (string | string[]): Request additional fields.

Usage

Fetching all watched episodes:

import { traktUsersHistoryLoader } from '@lekoarts/trakt-loader'

const usersHistory = defineCollection({
  loader: traktUsersHistoryLoader({
    id: 'trakt-username',
    type: 'episodes',
  }),
})

Fetching movie history for a specific date range:

import { traktUsersHistoryLoader } from '@lekoarts/trakt-loader'

const usersHistory = defineCollection({
  loader: traktUsersHistoryLoader({
    id: 'trakt-username',
    type: 'movies',
    start_at: '2024-01-01T00:00:00.000Z',
    end_at: '2024-12-31T23:59:59.999Z',
  }),
})