At Trakt, we collect lots of interesting information about what tv shows and movies everyone is watching. Part of the fun with such data is making it available for anyone to mash up and use on their own apps. The Trakt API was made just for this purpose. Let us know what you create!

This workspace contains multiple projects:

• api: Core library that implements Trakt API interactions using ts-rest and zod for type-safe communication and validation.
• playground: CLI project for testing and exploring the Trakt API functionality.
• openapi: Simple hono server that serves the API contract as an OpenAPI specification.

The following environment variables are required for the workspace to function properly:

• TRAKT_CLIENT_ID: The client ID for the Trakt API.
• TRAKT_CLIENT_SECRET: The client secret for the Trakt API.
  • Required for the playground project.

Want to contribute to Trakt ? Here's how to set up your development environment:

1. Create a Trakt Application: Navigate to Trakt Settings and create a new application.
2. Once your Trakt application is created, use the provided Client ID and Client Secret in your development environment.
3. Make use of the playground project to test out your changes by running playground:dev.

A Word of Caution, Fellow Traveler:

Please note that while using public applications is possible, they may have certain API limitations:

• Limited "Up Next" Access: The "Up Next" endpoint might be unavailable or return incomplete data.

These restrictions are implemented as part of Trakt's API security measures to prevent abuse from automated scrapers and unauthorized access.

This is a Deno project, so you need to have Deno installed on your machine please refer to the Deno installation guide.

1. Clone the repository
2. Install dependencies: deno task install
3. Run tasks:

• Workspace:

  • Format & Lint: deno task format

• Playground:

  • Development: deno task playground:dev

• OpenAPI:

  • Serve: deno task openapi
  • Development: deno task openapi:dev

Have questions or ideas? Share them in our GitHub Discussions.

Found a bug? Please report it in our GitHub Issues.

Make sure to follow our API Blog and @traktapi on Twitter for real time updates.

All of the libraries listed below are user contributed. If you find a bug or missing feature, please contact the developer directly. These might help give your project a head start, but we can't provide direct support for any of these libraries. Please help us keep this list up to date.