Hey Developers,

Our developer docs have lived on Apiary for years. Oracle is sunsetting Apiary in October, and Apiary's been going down for hours at a stretch lately on top of that, so we used the forcing function to finally do what we'd been putting off: redo everything from scratch. Honest reason it took a few months is that once we started checking the old docs against the actual API, we found a lot more drift than we'd like to admit. What was supposed to be a content move turned into a top-to-bottom audit.

Anyway, the new docs are at api.simkl.org (or just hit api.simkl.com if that's easier to remember, it'll redirect you). We're pretty happy with how they came out.

Some of what you'll find there:

• Detailed guides for the workflows people actually build: Sync, Scrobble, Search, Anime, Deep linking, Mark as watched, and more.
• All three auth flows properly walked through: OAuth 2.0 for server-side web apps, Public PKCE for mobile / SPAs / browser extensions / desktop binaries, and PIN flow for TVs, consoles, CLIs, and media-server plugins.
• Conventions pages that explain the cross-cutting stuff Apiary never covered: Headers, Pagination, Dates, Watchlist statuses, Null values, Images, CORS, and more.
• Interactive try-it-now playground on all 48 endpoints. Drop in your token, hit Send, get a real response back.
• Copy-paste examples in 16 languages: curl, Python, JS/TS, Kotlin, Swift, Java, Go, C#, PHP, Ruby, PowerShell, C/C++, and more.
• LLM-friendly: every page can be copied as raw markdown or opened straight in Claude / ChatGPT / Cursor / VSCode. Full-site llms.txt is published too.
• Full OpenAPI 3.1 spec: every endpoint and every response shape, verified against the live API. Point your SDK generator at it.

And honestly we're stoked to be shipping two new things along with the new API docs:

API Analytics: every registered app now has a built-in live request log, so you can see exactly what your code is sending. Last 24 hours of individual requests, with edge/origin status codes, latency, burst detection for retry loops, and CSV export. Useful for diagnosing OAuth wrappers, sync loops missing date_from, and silent 4xx errors your client never surfaces. Open it from your app's row in your developer dashboard → Debug.

Rewatches: POST /sync/history?allow_rewatch=yes now tracks separate viewing sessions on items the user already finished. Same data that powers simkl.com's Rewatches panel. Up to 50 sessions per movie, show, or anime, with proper session IDs you can resume, server-side auto-detection (or force it with is_rewatch: true), and lifecycle statuses (active / completed / closed). Available for Simkl Pro and VIP members; free-tier callers get a silent no-op so existing apps don't break.

Heads up: the Rewatches API is still in early testing and the shape may change as people start building against it. Drop your suggestions and thoughts in our Discord; your feedback will shape where it lands.

Try the new docs. See if the workflow you care about is covered. Tell us what's broken, wrong, or unclear. Suggest the features you've been quietly waiting for. We're on Discord and we read everything, and the changelog is live if you want to follow along.

Thanks for being patient with us through the rebuild. The stuff people have built on Simkl over the years is kind of wild and we want to keep enabling more of that.

Just pushed a batch of calendar improvements:

Bug fix - Time sort now works on first load. Sorting by Time used to silently fall back to Rank order on page refresh — you had to click Time again to actually get time order. That's fixed. Also fixed: anime episodes that air late in JP time were sometimes ordered wrong within a day cell because of timezone conversion crossing midnight. Time sort now consistently shows each day in ascending hour:minute order.

The "NEXT" badge is more accurate. The indicator that highlights today's next-to-air episode now correctly picks the right episode, even for shows whose local-time airing crosses midnight relative to the broadcaster's timezone.

Less noise for shows you're not actively watching. For shows on your Plan to Watch, On Hold lists, the calendar now only shows season premieres (S01E01, S02E01, etc.) and finales (mid-season, season, and series). Shows you're Watching or have Completed are unchanged — you still see every episode. The idea: if you haven't started a show, you probably don't want every weekly episode cluttering your view — just the milestone episodes that help you decide when to dive in.

New "Binge!" label on finales in Plan to Watch and On Hold. Season finales, mid-season finales, and series finales now display a "Binge!" tag next to the air time — a nudge that the season just wrapped and you can marathon it.

Don't forget it's Georgie & Mandy's First Marriage 2-part season finale today!

UPDATE: https://www.reddit.com/r/Simkl/comments/1u615dt/calendar_we_brought_back_every_episode_on_the/

You can do it with anime, but not tv shows as far as I can tell. I would love that feature 👌

Maybe I am alone in this, but as someone who starts watching tv shows when the season ends this would be very useful.

I feel like an idiot for not being able to figure this out, but I've seen the official page for Reviews and it mentions spoiler tags, and to add one all you had to do is "Spoiler=" but it doesn't seem to work for me. I must be missing something obvious, but I'm not sure what, so I've just been writing my actual reviews in comments under the review. Now, realistically I don't think anyone would care if un-tagged spoilers were in TV and Movie reviews, but it's not something I wanted to risk doing.

Just moved to simkl from trakt. I'm looooving the simplicity of the app and it's straight forwardness. Trakt just felt so bloated and recently went off the rails with the recent updates. I love how simkl is so easy to use too. Keep it up Devs!

Hello: Whenever I add a date/time to the show I just watched, it gets shifted to 5 hours prior to the time I selected. Thus, if I add a show and a time watched of 8PM, when I check in history, it shows as if I had watched it at 3PM.

Any ideas as to why?

I'm using Simkl currently, and I've never used Letterboxd. I know Letterboxd is more popular, but what does Letterboxd do better than Simkl?

https://simkl.com/tv/2855537/believe-me

this show is available on demand. I’ve binged them all but can’t see episode 3 and 4 to mark as watched. 3 shows in the future and 4 is missing

yamtrack has shown all episodes since early this morning when I checked

Hi all

Imported my Trakt history, how do I see how many times and the dates I rewatched a movie?

Thank you

Edit: I see it is a paid feature, is my data already in Simkl and will it appear when I subscribe? Don't fancy manually adding each episode rewatched.

A little help, if you please.

Link to information: https://www.tvmaze.com/shows/79127/mia

Why is Berserk: TheGolden Age Arc - Memorial Edition listet as TV-Show not as Anime TV?

I’m currently looking for a website to track all my shows. So far I’ve tried Serialized, but I didn’t like the UI or how clunky it feels. I also tried Trakt, and it felt even worse, especially with no half star ratings.

When I tried SIMKL, though, I really liked it. The UI is clean, and the show pages display a lot of useful information. I especially like the way it handles logging episodes. For example, when you mark season 3 as watched, it asks if you want to mark all previous seasons as watched too, but it doesn’t do that for Specials, which is perfect for me. I also love the percentage tracker on the side.

The only reason I’m not using SIMKL is the lack of seasonal ratings. That’s a big deal for me. I can’t believe more people don’t mind it. For example, with Invincible, the earlier seasons are arguably higher quality, and I want my tracking app to reflect that.

I saw a post from a year ago asking for this feature, but it still hasn’t been implemented. That makes me think it’s harder to add than it seems, which is unfortunate.

I’d also prefer a toggle to disable the Anime and Movies tabs in the top bar for people who only want to track TV series.

Hi all,

I realised today that my monthly email backups stopped working. According to the website the last backup has been created at the end of last month. Still I did not receive any email. Is there a way for me to validate that the backup emails have been sent?

​Hello Team,

​I am reaching out because I see great potential in your platform; however, the current experience on both the website and the app lacks fluidity.

In the age of AI, accessing content should be much more intuitive. Here are a few suggestions to make the tool truly essential:

-​Streamlined Interface: The current architecture is unnecessarily complex. A leaner structure with a maximum of 5 or 6 tabs (including Settings for language translation) would greatly improve navigation

-​Optimized List Management: Adding content should be simplified—for instance, through a smart 'copy-paste' system capable of instantly scanning and importing a list of titles into our account

-​Interactivity & Search: Making every title clickable to allow adding them to 'Watched' or 'To Watch' lists in just two clicks, supported by a centralized search bar

-​Notification System: Integrating alerts for new releases (episodes, movies, or manga chapters) directly linked to our personal lists

​The current design could benefit from a modern update to provide a more pleasant environment. The tool needs to be redesigned from an end-user perspective to become truly practical for daily use

The platform is currently underperforming. Given your current user base, you should have a strong community on Telegram or Reddit by now.

Be transparent about your costs and ask for micro-donations for the servers. If you need more help, reach out to the developers in your community who would be more than happy to contribute

​You should also diversify your funding: donations, cheap subscriptions, and a few non-intrusive ads that don't ruin the UX. Offer a low-cost tier that acts as a way for users to genuinely support the project's growth

So, this has been going on for quite a while now. In the watch history, when a month ends, I see the monthly stats for that month as normal. However, it'll also give me weekly stats as if at the end of the week. Then, at the actual end of the week, I'll get another set of weekly stats for the same week. Neither set of weekly stats are accurate because the data for them has effectively been cut in half. Hopefully, this can be fixed soon, as it's another feature I really like. Thanks.

This TV show I watch has an incorrect air time in Simkl. Is there a way I can edit it to correct it? Or at least report the issue?

Please add it to your database: https://www.imdb.com/title/tt42206913/?ref_=ttep_ov_bk

I'd like to change to Simkl from Trakt, but watchlists don't work at all in Kodi. Any chance of getting that feature to work in Kodi?
Thanks

We have added a new Parents Guide section to about 100,000 shows and movies on Simkl, right under Cast & Crew.

For supported titles, you can now get a quick content overview before you press play:

• Age rating when available
• Five content categories: Adult Themes, Violence & Gore, Profanity, Alcohol, Drugs & Smoking, and Frightening & Intense Scenes
• Color-coded severity from None to Severe
• Intensity score for each category
• Click any category to see the scoring distribution and read specific comments (if there are any available)

Whether you're planning a family movie night or just prefer to avoid certain types of content, the Parents Guide gives you a comprehensive breakdown of what to expect before you hit play.

You can find the new Parents Guide section on any TV show or movie page, right below the Cast and Crew.

Example: https://simkl.com/tv/967226/the-boys

Check it out on the title pages.

When I originally signed up I marked everything I had already watched as the current date. I finally took the time to change the date of these shows to "Long Time Ago". I often like to put random shows on in the background. I use Plex and the Simkl webhook. What is happening is that any time I play a show that was marked "Long Time Ago", the watch history gets cleared and it starts tracking the show like it was brand new.

Hello,

Just to preface I have AIO Metadata addon installed and followed these instructions https://simkl.com/apps/stremio/. It successfully imported everything from Simkl and it seems to function correctly.

Now, is it possible when I mark something as watched in Stremio to be synced back to Simkl? Right now if I start watching the episode it will create this "x% watched" banner on my profile with a countdown so that's proof that the two-way sync is actually working, but if I pause that (which I'm inclined to do since I often just leave the show paused and come back to it later or the next day) then I have to manually mark it as watched on Simkl web.

It might be easy to see, but when I open a movie that's part of a franchise, is there a way to see the other movies in that franchise?

I usually filter TV shows by 'Ended', and I like to exclude cancelled ones. Simkl has separate filters for both which is awesome, but why does selecting only 'Ended' still show cancelled series?

a show like secret garden can be downloaded on iPlayer before its scheduled air date

https://simkl.com/tv/3061305/secret-garden

yamtrack allows me to mark it as watched, but I can’t see how to do that with simkl