Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.simkl.org/llms.txt

Use this file to discover all available pages before exploring further.

The Movies API returns metadata about theatrical movies in Simkl’s catalog. None of these endpoints require an OAuth token — a client_id is enough.

​
Look up a movie

Movie details

GET /movies/{id} — full record (overview, director, runtime, country, certification, genres, ratings, similar-movie recommendations, posters, fanart, trailers, external IDs, alternate titles, per-region release dates, budget, revenue). Cloudflare-cached by Simkl ID — see Rate limits → Parallel requests.
If you only have an external ID (IMDb, TMDB), resolve it to a Simkl ID via GET /redirect first — header-only, Cloudflare-cached, and the canonical resolver.

​
Browse & discover

Genres

GET /movies/genres/... — browse by genre, country, year, and sort order.

​
Pre-built data files (no per-user cost)

Two static JSON resources on the CDN cover the most common “what’s hot / what’s releasing” surfaces without paying any per-user request budget. Send the standard URL parameters and User-Agent; no Authorization token needed.

Trending movies

https://data.simkl.in/trending/movies_today.json + week / month variants, plus Top-100 and Top-500 versions. Refreshed daily. Drives “Most Watched” / “Trending Now” surfaces without polling.

Movie releases calendar

https://data.simkl.in/calendar/movie_release.json + per-month archives at /calendar/{YEAR}/{MONTH}/movie_release.json. Updated every 6 hours. Also covers DVD releases.