Skip to main content
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.