📚 API Documentation Update

[kevincador]

Hi developers,

We’re officially deprecating the old Trakt API documentation at: https://trakt.docs.apiary.io

Going forward, the main home for the Trakt API documentation is: https://docs.trakt.tv

The new docs are powered by ReadMe and backed by our OpenAPI document, which is maintained in this repository.

🛠️ Why we’re moving

This should make the documentation easier for us to support, improve, and keep up to date over time.

It also gives developers a better way to explore the API, including the ability to try requests directly in the browser when testing endpoints and new features.

🧩 Some gaps are expected

During the transition, you may notice that some endpoints are documented in one place but not the other, or the other way around.

That’s expected while we continue filling the gaps and improving the new documentation.

🙋 What you can do

If you rely on something that’s missing, unclear, or different in the new docs, please let us know by opening an issue in this repository.

Please include what endpoint or behavior you use, what information is missing, and where the current docs are unclear. That will help us prioritize and fill the gaps faster.

---

Thanks for building with Trakt, and for helping us make the API documentation better for everyone ✨

[mfederowicz]

hey @kevincador great new, but I have a question: is it possible to somehow get history of modification of list endpoints, and of course for future development improvement (for other developers who develop tools/libs depends on api endpoints)?

[kevincador]

Not in the current state of the migration but this is something we're looking into. The new documentation has a change log module that will be tested. Thanks for the feedback!

[MaxHasADHD]

The new documentation page looks great. Is there a timeline as to when all of the endpoints will be in the right place, and accurate? I see a lot of missing endpoints, but also perhaps some internal / missing endpoints. Like JustWatch / Younify give me 401 unauthorized. "Hot movies" gives me 404. I'm sure there are more.

[mfederowicz]

yeah next example https://trakt.docs.apiary.io/#reference/people/updates/get-recently-updated-people and https://trakt.docs.apiary.io/#reference/people/updated-ids/get-recently-updated-people

[kevincador]

JustWatch and Younify are internal only (Limited Access). JustWatch has already been flagged as such. I'll flag Younify too.

Missing endpoint were just added now, including recently updated people.

I'll look into hot movies, not sure about that one 👀

[jonathanantoine]

Hello,

A feature request for the new website if possible : allow to extract the whole documentation (or at least a page) to provide it to our IDE/LLM locally.

Thanks :)

[kevincador]

You can now do this:

And you also have access to https://docs.trakt.tv/llms.txt with links to the guides and the API Reference for llms.

Enjoy! And thanks for the suggestion!!

[jonathanantoine]

Thanks a lot!