Full detail record for one movie — title, overview, year, runtime, country, language, certification, genres, director, ratings, posters, fanart, external IDs, alternate titles, release-date list per region, budget, revenue, trailers, similar-movie recommendations. The default response is already complete; no flags needed.
Responses are Cloudflare-cached by Simkl ID, so repeat lookups of popular titles are near-free. Parallel requests against this endpoint are explicitly allowed (see Rate limits → Parallel requests).
Cache invalidation is automatic. When Simkl updates the underlying record (admin edits, automated metadata refresh, image swap, related-titles change, etc.), the corresponding Cloudflare cache entry is purged server-side. The next call to this endpoint returns the fresh data — there’s no TTL to wait out and no client-side cache-busting needed. Your own app-level cache, if any, still has to be invalidated by your client.
Use a Simkl ID for the lookup. If you only have an external ID, resolve it via GET /redirect first.
Which IDs can I send/expect? All accepted input identifiers and the keys you’ll see echoed back in responses are listed at Standard media objects → Supported ID keys. Send every ID you have on writes — Simkl picks the first that resolves and ignores the rest. Reminder: slug is response-only (never send it on a request).
using RestSharp;
var options = new RestClientOptions("https://api.simkl.com/movies/{id}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("User-Agent", "<user-agent>");
request.AddHeader("simkl-api-key", "<api-key>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
using RestSharp;
var options = new RestClientOptions("https://api.simkl.com/movies/{id}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("User-Agent", "<user-agent>");
request.AddHeader("simkl-api-key", "<api-key>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
Optional alias for the client_id query parameter. Simkl accepts your client_id either as the simkl-api-key request header or as the ?client_id=… query parameter — pick one. The query-parameter form is preferred because it makes the request fully self-describing in URL form.
Headers
User-Agent
string
required
Descriptive identifier for your app, ideally name/version. Examples: PlexMediaServer/1.43.1.10540, kodi-simkl/0.9.2, MyApp/2.4.1 (https://myapp.com).
Path Parameters
id
string
required
Simkl ID for the item. Simkl IDs are stable, unambiguous, and the response is Cloudflare-cached by Simkl ID, so repeat lookups are very fast.
If you only have an external ID (IMDb, TMDB, TVDB, MAL, AniDB, etc.), resolve it to a Simkl ID first via GET /redirect — it returns the Simkl ID in the Location header without a JSON payload, and the follow-up detail call is Cloudflare-cached.
Short, lowercase identifier for your app (e.g. plex-scrobbler, kodi-bridge). Helps Simkl identify which apps are using the API.
app-version
string
required
Your app's current version (e.g. 1.0, 2.4.1). Helps Simkl debug issues you report.
Response
OK
Full movie record returned by GET /movies/{id}. The response shape is the same regardless of any extended query value — the parameter is a legacy no-op for this endpoint. Responses are Cloudflare-cached by Simkl ID. See Null and missing values for the nullable-field semantics used below.
title
string
required
Display title in the response language (defaults to English unless the request's language overrides it).
year
integer
required
Release year.
type
enum<string>
required
Always movie on this endpoint.
Available options:
movie
ids
object
required
External and internal identifiers for an item. Pass as many as you have — Simkl resolves to the canonical record.
Hide child attributes
ids.simkl
integer
Simkl internal ID. Most reliable.
Example:
53536
ids.slug
string
URL-safe slug returned in responses.
Example:
"attack-on-titan"
ids.imdb
string
IMDb ID.
Example:
"tt0181852"
ids.tmdb
string
TMDb ID.
Example:
"296"
ids.tvdb
string
TVDB ID or slug.
Example:
"153021"
ids.mal
string
MyAnimeList ID.
Example:
"4246"
ids.anidb
string
AniDB ID. Specifying just this is enough for anime lookups.
Type 4 null — data not on file in that field's slot. See Null and missing values. Position in Simkl's popularity ranking. Null when not ranked.
droprate
string | null
Percentage of users who started watching but dropped, e.g. "0.1%". Type 4 null when the metric isn't computed.
poster
string | null
Poster image path. Compose the full URL via Images. Type 4 null when no poster on file.
fanart
string | null
Background/hero image path. Type 4 null when no fanart on file.
released
string<date> | null
Initial release date (YYYY-MM-DD). Type 4 null when unknown.
runtime
integer | null
Runtime in minutes. Type 4 null when not on file.
director
string | null
Primary director. Type 4 null when unknown.
certification
string | null
Content rating (e.g. PG-13, R). Type 4 null when not rated for the response country.
budget
integer | null
Production budget in USD. Type 4 null when not on file.
revenue
integer | null
Box-office revenue in USD. Type 4 null when not on file.
overview
string | null
Plot synopsis. Type 4 null when no overview is available.
genres
string[]
Genre names.
country
string
ISO 3166-1 alpha-2 production country code.
language
string
ISO 639-1 language code in UPPERCASE.
original_language
string | null
Type 4 null — no language on file for this title. See Null and missing values. The title's original language as a lower-case ISO 639-1 code (en, ja, ko) — the same field and format as original_language in the trending and calendar files. Movies also return language: the same code in upper case.
Example:
"en"
alt_titles
object[]
Localized and alternate titles. May contain many entries for popular titles.
Hide child attributes
alt_titles.name
string
alt_titles.lang
integer
Simkl internal language code.
alt_titles.type
enum<string>
Classification of an entry in alt_titles. official = broadcaster/distributor-supplied localization, short = shortened form, synonym = community-supplied alias, original = original-language title (typically Japanese for anime).
Available options:
official,
short,
synonym,
original
ratings
object
Ratings keyed by source. Movies always carry simkl and imdb.
Hide child attributes
ratings.simkl
object
External-source rating.
Hide child attributes
ratings.simkl.rating
number
Rating value (0–10).
Required range: 0 <= x <= 10
ratings.simkl.votes
integer
Number of votes contributing to the rating.
ratings.imdb
object
External-source rating.
Hide child attributes
ratings.imdb.rating
number
Rating value (0–10).
Required range: 0 <= x <= 10
ratings.imdb.votes
integer
Number of votes contributing to the rating.
ratings.{key}
object
External-source rating.
Hide child attributes
ratings.{key}.rating
number
Rating value (0–10).
Required range: 0 <= x <= 10
ratings.{key}.votes
integer
Number of votes contributing to the rating.
trailers
object[] | null
YouTube-hosted trailers and promo clips. Type 4 null when no trailers on file. Order: English-language videos first, then by type in the order listed on that field (trailer first, opening_credits last; videos with no type sit right after the trailers), then largest size first.
Type 4 null — data not on file in that field's slot. See Null and missing values. Max video resolution height (720, 1080, 2160).
trailers.type
enum<string> | null
Type 4 null — the video has no kind on file. See Null and missing values. What the video is: trailer, teaser, clip, featurette, behind_the_scenes, bloopers or opening_credits. Filter on it to show trailers only, or to group extras by kind.
Type 4 null — data not on file in that field's slot. See Null and missing values. Background image path, same format as poster.
users_recommendations.type
string
users_recommendations.ids
object
Hide child attributes
users_recommendations.ids.simkl
integer
users_recommendations.ids.slug
string
similar
object[]
Titles in the same genres — the strip shown at the bottom of this title's page on simkl.com. Unlike users_recommendations, it is based on genre rather than on what this title's viewers watched, so it carries no users_percent or users_count.
Type 2 — omitted entirely when there is nothing to show, rather than returned as an empty array. See Null and missing values.
using RestSharp;
var options = new RestClientOptions("https://api.simkl.com/movies/{id}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("User-Agent", "<user-agent>");
request.AddHeader("simkl-api-key", "<api-key>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
using RestSharp;
var options = new RestClientOptions("https://api.simkl.com/movies/{id}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("User-Agent", "<user-agent>");
request.AddHeader("simkl-api-key", "<api-key>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Simkl API","description":"Build apps that track Movies, TV Shows, and Anime — scrobble playback, sync watch history, and pull rich metadata from the Simkl API.","colors":{"primary":"#3B82F6","light":"#7DAEFF","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/andrewmasyk/yVND0Vg0vHbm_kqK/logo/light.svg?fit=max\u0026auto=format\u0026n=yVND0Vg0vHbm_kqK\u0026q=85\u0026s=3ed4c7fdfb9f19455db11c9a13dd466e","dark":"https://mintcdn.com/andrewmasyk/yVND0Vg0vHbm_kqK/logo/dark.svg?fit=max\u0026auto=format\u0026n=yVND0Vg0vHbm_kqK\u0026q=85\u0026s=01045ebbe2fa107aed1f989ec1622647","href":"https://api.simkl.org"},"favicon":"https://mintcdn.com/andrewmasyk/RbJc6mqlYX6FcPwH/favicon.svg?fit=max\u0026auto=format\u0026n=RbJc6mqlYX6FcPwH\u0026q=85\u0026s=d5bd6b8d56f55059c6307fb1e0db9fb7","api":{"openapi":"openapi.json","params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","typescript","kotlin","swift","java","node","go","csharp","dotnet","php","ruby","powershell","c++","c"],"prefill":true,"autogenerate":true}},"appearance":{"default":"dark","strict":false},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://support.simkl.com","label":"Support"},{"href":"https://discord.gg/MJsWNE4","label":"Discord"}],"primary":{"type":"button","label":"Get an API key","href":"https://simkl.com/settings/developer/"}},"footer":{"socials":{"x":"https://twitter.com/Simkl","discord":"https://discord.gg/MJsWNE4"},"links":[{"header":"Resources","items":[{"label":"Quickstart","href":"/quickstart"},{"label":"API Reference","href":"/api-reference/introduction"},{"label":"Standard objects","href":"/conventions/standard-media-objects"},{"label":"Rate limits","href":"/resources/rate-limits"},{"label":"API rules","href":"/api-rules"},{"label":"OpenAPI 3.1 spec","href":"/openapi.json"}]},{"header":"Simkl","items":[{"label":"Simkl.com","href":"https://simkl.com"},{"label":"Get an API key","href":"https://simkl.com/settings/developer"},{"label":"Status","href":"https://status.simkl.com/"},{"label":"Terms","href":"https://simkl.com/about/policies/terms"}]},{"header":"Community","items":[{"label":"Discord","href":"https://discord.gg/MJsWNE4"},{"label":"X","href":"https://twitter.com/Simkl"}]}]},"seo":{"metatags":{"og:image":"https://i.simkl.com/img_tv/apiary_logo_api.png","og:site_name":"Simkl API"},"indexing":"all"},"fonts":{"family":"Open Sans"},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"vesper"}},"latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","grok","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark"},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"andrewmasyk","hasAudioNarration":false,"actualSubdomain":"andrewmasyk","customDomains":["api.simkl.org"],"gitSource":{"type":"github","owner":"simkl","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afa16e82e6041f078dab076","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":91},{"language":"default","tag":"Documentation","count":27},{"language":"default","tag":"Auth","count":21},{"language":"default","tag":"AUTH V2","count":11},{"language":"default","tag":"Custom Lists","count":10},{"language":"default","tag":"Sync","count":10},{"language":"default","tag":"AUTH V1","count":9},{"language":"default","tag":"Conventions","count":8},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Browse \u0026 discover","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/andrewmasyk/10e184c8f2642821/style.css"}]}
{"page":{"pagePath":"api-reference/simkl/get-movie","slug":"/api-reference/simkl/get-movie","pageMetadata":{"title":"Movie details","description":"Full detail record for one movie — title, overview, year, runtime, country, language, certification, genres, director, ratings, posters, fanart, external IDs, alternate titles, release-date list per region, budget, revenue, trailers, similar-movie recommendations. The default response is already complete; no flags needed.\n\nResponses are **Cloudflare-cached by Simkl ID**, so repeat lookups of popular titles are near-free. Parallel requests against this endpoint are explicitly allowed (see [Rate limits → Parallel requests](/resources/rate-limits#parallel-requests-when-allowed)).\n\n**Cache invalidation is automatic.** When Simkl updates the underlying record (admin edits, automated metadata refresh, image swap, related-titles change, etc.), the corresponding Cloudflare cache entry is purged server-side. The next call to this endpoint returns the fresh data — there's no TTL to wait out and no client-side cache-busting needed. Your own app-level cache, if any, still has to be invalidated by your client.\n\nUse a Simkl ID for the lookup. If you only have an external ID, resolve it via [`GET /redirect`](/api-reference/redirect) first.\n\n\u003cTip>\n**Which IDs can I send/expect?** All accepted input identifiers and the keys you'll see echoed back in responses are listed at [**Standard media objects → Supported ID keys**](/conventions/standard-media-objects#supported-id-keys). Send every ID you have on writes — Simkl picks the first that resolves and ignores the rest. Reminder: `slug` is **response-only** (never send it on a request).\n\u003c/Tip>","deprecated":null,"version":null,"sidebarTitle":"Movie details","openapi":"/openapi.json get /movies/{id}","href":"/api-reference/simkl/get-movie","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n }, {Tip} = _components;\n if (!Tip) _missingMdxReference(\"Tip\", true);\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Full detail record for one movie — title, overview, year, runtime, country, language, certification, genres, director, ratings, posters, fanart, external IDs, alternate titles, release-date list per region, budget, revenue, trailers, similar-movie recommendations. The default response is already complete; no flags needed.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Responses are \", _jsx(_components.strong, {\n children: \"Cloudflare-cached by Simkl ID\"\n }), \", so repeat lookups of popular titles are near-free. Parallel requests against this endpoint are explicitly allowed (see \", _jsx(_components.a, {\n href: \"/resources/rate-limits#parallel-requests-when-allowed\",\n children: \"Rate limits → Parallel requests\"\n }), \").\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Cache invalidation is automatic.\"\n }), \" When Simkl updates the underlying record (admin edits, automated metadata refresh, image swap, related-titles change, etc.), the corresponding Cloudflare cache entry is purged server-side. The next call to this endpoint returns the fresh data — there’s no TTL to wait out and no client-side cache-busting needed. Your own app-level cache, if any, still has to be invalidated by your client.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Use a Simkl ID for the lookup. If you only have an external ID, resolve it via \", _jsx(_components.a, {\n href: \"/api-reference/redirect\",\n children: _jsx(_components.code, {\n children: \"GET /redirect\"\n })\n }), \" first.\"]\n }), \"\\n\", _jsx(Tip, {\n children: _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Which IDs can I send/expect?\"\n }), \" All accepted input identifiers and the keys you’ll see echoed back in responses are listed at \", _jsx(_components.a, {\n href: \"/conventions/standard-media-objects#supported-id-keys\",\n children: _jsx(_components.strong, {\n children: \"Standard media objects → Supported ID keys\"\n })\n }), \". Send every ID you have on writes — Simkl picks the first that resolves and ignores the rest. Reminder: \", _jsx(_components.code, {\n children: \"slug\"\n }), \" is \", _jsx(_components.strong, {\n children: \"response-only\"\n }), \" (never send it on a request).\"]\n })\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"vesper"}},"config":{},"pageMetadata":{"title":"Movie details","description":"Full detail record for one movie — title, overview, year, runtime, country, language, certification, genres, director, ratings, posters, fanart, external IDs, alternate titles, release-date list per region, budget, revenue, trailers, similar-movie recommendations. The default response is already complete; no flags needed.\n\nResponses are **Cloudflare-cached by Simkl ID**, so repeat lookups of popular titles are near-free. Parallel requests against this endpoint are explicitly allowed (see [Rate limits → Parallel requests](/resources/rate-limits#parallel-requests-when-allowed)).\n\n**Cache invalidation is automatic.** When Simkl updates the underlying record (admin edits, automated metadata refresh, image swap, related-titles change, etc.), the corresponding Cloudflare cache entry is purged server-side. The next call to this endpoint returns the fresh data — there's no TTL to wait out and no client-side cache-busting needed. Your own app-level cache, if any, still has to be invalidated by your client.\n\nUse a Simkl ID for the lookup. If you only have an external ID, resolve it via [`GET /redirect`](/api-reference/redirect) first.\n\n\u003cTip>\n**Which IDs can I send/expect?** All accepted input identifiers and the keys you'll see echoed back in responses are listed at [**Standard media objects → Supported ID keys**](/conventions/standard-media-objects#supported-id-keys). Send every ID you have on writes — Simkl picks the first that resolves and ignores the rest. Reminder: `slug` is **response-only** (never send it on a request).\n\u003c/Tip>","deprecated":null,"version":null,"sidebarTitle":"Movie details","openapi":"/openapi.json get /movies/{id}","href":"/api-reference/simkl/get-movie","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/andrewmasyk/c998d3ea10630993/scripts.js"],"openApiReferenceData":{"operation":{"operationId":"get-movies-id","summary":"Movie details","description":"Full detail record for one movie — title, overview, year, runtime, country, language, certification, genres, director, ratings, posters, fanart, external IDs, alternate titles, release-date list per region, budget, revenue, trailers, similar-movie recommendations. The default response is already complete; no flags needed.\n\nResponses are **Cloudflare-cached by Simkl ID**, so repeat lookups of popular titles are near-free. Parallel requests against this endpoint are explicitly allowed (see [Rate limits → Parallel requests](/resources/rate-limits#parallel-requests-when-allowed)).\n\n**Cache invalidation is automatic.** When Simkl updates the underlying record (admin edits, automated metadata refresh, image swap, related-titles change, etc.), the corresponding Cloudflare cache entry is purged server-side. The next call to this endpoint returns the fresh data — there's no TTL to wait out and no client-side cache-busting needed. Your own app-level cache, if any, still has to be invalidated by your client.\n\nUse a Simkl ID for the lookup. If you only have an external ID, resolve it via [`GET /redirect`](/api-reference/redirect) first.\n\n\u003cTip>\n**Which IDs can I send/expect?** All accepted input identifiers and the keys you'll see echoed back in responses are listed at [**Standard media objects → Supported ID keys**](/conventions/standard-media-objects#supported-id-keys). Send every ID you have on writes — Simkl picks the first that resolves and ignores the rest. Reminder: `slug` is **response-only** (never send it on a request).\n\u003c/Tip>","parameters":["74ce7842-a7e9-40cc-941a-83a4083bfa47","4595c683-215d-4c19-be08-59fd11af85df","8bb4bddc-3806-4834-9e3f-cc6f08138c49","b45945a0-9ac5-4c3e-981d-d22294ee371a","073dbe33-4a92-44aa-9f33-2637cc218404"],"responses":{"200":"dcafff70-b502-424a-880b-1014b19c7ca8","404":"88d0202a-51a0-4f63-8cf0-b606ce32fb21","412":"b6537332-bdf0-4ee5-a9b9-4ce8fa7ddbe9","429":"33de15e2-f039-45c6-97a5-8df116b79900","500":"ca77c3a2-024b-4288-8b5a-008da2c14044"},"tags":["Movies"],"x-mint":{"href":"/api-reference/simkl/get-movie","metadata":{"sidebarTitle":"Movie details"}},"security":["0404796a-744a-47b8-ae7e-5c77caec72f8"],"method":"get","type":"path","servers":["1ff7513b-7c65-431d-a68f-d379fa335309","23b65516-5008-4875-b78d-4bd0b879e4f4"],"path":"/movies/{id}","baseUrlOptions":["https://api.simkl.com","https://data.simkl.in"],"title":"Movie details","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","typescript","kotlin","swift","java","node","go","csharp","dotnet","php","ruby","powershell","c++","c"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"74ce7842-a7e9-40cc-941a-83a4083bfa47":{"name":"id","in":"path","description":"**Simkl ID** for the item. Simkl IDs are stable, unambiguous, and the response is Cloudflare-cached by Simkl ID, so repeat lookups are very fast.\n\n**If you only have an external ID** (IMDb, TMDB, TVDB, MAL, AniDB, etc.), resolve it to a Simkl ID first via [`GET /redirect`](/api-reference/redirect) — it returns the Simkl ID in the `Location` header without a JSON payload, and the follow-up detail call is Cloudflare-cached.","required":true,"schema":{"type":"string","isRequired":true,"description":"**Simkl ID** for the item. Simkl IDs are stable, unambiguous, and the response is Cloudflare-cached by Simkl ID, so repeat lookups are very fast.\n\n**If you only have an external ID** (IMDb, TMDB, TVDB, MAL, AniDB, etc.), resolve it to a Simkl ID first via [`GET /redirect`](/api-reference/redirect) — it returns the Simkl ID in the `Location` header without a JSON payload, and the follow-up detail call is Cloudflare-cached.","uniqueKey":"","typeLabel":"string"},"example":"472214"},"4595c683-215d-4c19-be08-59fd11af85df":{"name":"client_id","in":"query","required":true,"description":"Your **`client_id`** from your [Simkl developer settings](https://simkl.com/settings/developer/). Required on every request.","schema":{"type":"string","isRequired":true,"description":"Your **`client_id`** from your [Simkl developer settings](https://simkl.com/settings/developer/). Required on every request.","uniqueKey":"","typeLabel":"string"},"example":"YOUR_CLIENT_ID"},"8bb4bddc-3806-4834-9e3f-cc6f08138c49":{"name":"app-name","in":"query","required":true,"description":"Short, lowercase identifier for your app (e.g. `plex-scrobbler`, `kodi-bridge`). Helps Simkl identify which apps are using the API.","schema":{"type":"string","isRequired":true,"description":"Short, lowercase identifier for your app (e.g. `plex-scrobbler`, `kodi-bridge`). Helps Simkl identify which apps are using the API.","uniqueKey":"","typeLabel":"string"},"example":"my-app"},"b45945a0-9ac5-4c3e-981d-d22294ee371a":{"name":"app-version","in":"query","required":true,"description":"Your app's current version (e.g. `1.0`, `2.4.1`). Helps Simkl debug issues you report.","schema":{"type":"string","isRequired":true,"description":"Your app's current version (e.g. `1.0`, `2.4.1`). Helps Simkl debug issues you report.","uniqueKey":"","typeLabel":"string"},"example":"1.0"},"073dbe33-4a92-44aa-9f33-2637cc218404":{"name":"User-Agent","in":"header","required":true,"description":"Descriptive identifier for your app, ideally `name/version`. Examples: `PlexMediaServer/1.43.1.10540`, `kodi-simkl/0.9.2`, `MyApp/2.4.1 (https://myapp.com)`.","schema":{"type":"string","isRequired":true,"description":"Descriptive identifier for your app, ideally `name/version`. Examples: `PlexMediaServer/1.43.1.10540`, `kodi-simkl/0.9.2`, `MyApp/2.4.1 (https://myapp.com)`.","uniqueKey":"","typeLabel":"string"},"example":"my-app/1.0"}},"responses":{"dcafff70-b502-424a-880b-1014b19c7ca8":{"description":"OK","headers":{},"content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Full movie record returned by `GET /movies/{id}`. The response shape is the same regardless of any `extended` query value — the parameter is a legacy no-op for this endpoint. Responses are Cloudflare-cached by Simkl ID. See [Null and missing values](/conventions/null-values) for the nullable-field semantics used below.","required":["title","year","type","ids"],"properties":{"title":{"type":"string","description":"Display title in the response language (defaults to English unless the request's `language` overrides it).","isRequired":true,"uniqueKey":"oneOf.0.title","typeLabel":"string"},"year":{"type":"integer","description":"Release year.","isRequired":true,"uniqueKey":"oneOf.0.year","typeLabel":"integer"},"type":{"type":"string","enum":["movie"],"description":"Always `movie` on this endpoint.","isRequired":true,"uniqueKey":"oneOf.0.type","typeLabel":"enum\u003cstring>"},"ids":{"type":"object","description":"External and internal identifiers for an item. Pass as many as you have — Simkl resolves to the canonical record.","properties":{"simkl":{"type":"integer","description":"Simkl internal ID. Most reliable.","example":53536,"uniqueKey":"oneOf.0.ids.simkl","typeLabel":"integer"},"slug":{"type":"string","description":"URL-safe slug returned in responses.","example":"attack-on-titan","uniqueKey":"oneOf.0.ids.slug","typeLabel":"string"},"imdb":{"type":"string","description":"IMDb ID.","example":"tt0181852","uniqueKey":"oneOf.0.ids.imdb","typeLabel":"string"},"tmdb":{"type":"string","description":"TMDb ID.","example":"296","uniqueKey":"oneOf.0.ids.tmdb","typeLabel":"string"},"tvdb":{"description":"TVDB ID or slug.","example":"153021","type":"string","uniqueKey":"oneOf.0.ids.tvdb","typeLabel":"string"},"mal":{"type":"string","description":"MyAnimeList ID.","example":"4246","uniqueKey":"oneOf.0.ids.mal","typeLabel":"string"},"anidb":{"type":"string","description":"AniDB ID. Specifying just this is enough for anime lookups.","example":"10846","uniqueKey":"oneOf.0.ids.anidb","typeLabel":"string"},"anilist":{"type":"string","description":"AniList ID.","example":"21","uniqueKey":"oneOf.0.ids.anilist","typeLabel":"string"},"kitsu":{"type":"string","description":"Kitsu ID.","example":"12","uniqueKey":"oneOf.0.ids.kitsu","typeLabel":"string"},"anisearch":{"type":"string","description":"aniSearch ID.","example":"2227","uniqueKey":"oneOf.0.ids.anisearch","typeLabel":"string"},"animeplanet":{"type":"string","description":"Anime-Planet slug.","example":"one-piece","uniqueKey":"oneOf.0.ids.animeplanet","typeLabel":"string"},"livechart":{"type":"string","description":"LiveChart ID.","example":"321","uniqueKey":"oneOf.0.ids.livechart","typeLabel":"string"},"letterboxd":{"type":"string","description":"Letterboxd slug.","example":"the-truman-show","uniqueKey":"oneOf.0.ids.letterboxd","typeLabel":"string"},"netflix":{"type":"string","description":"Netflix movie ID.","example":"70210890","uniqueKey":"oneOf.0.ids.netflix","typeLabel":"string"},"hulu":{"type":"string","description":"Hulu episode ID.","uniqueKey":"oneOf.0.ids.hulu","typeLabel":"string"},"crunchyroll":{"type":"string","description":"Crunchyroll episode ID.","uniqueKey":"oneOf.0.ids.crunchyroll","typeLabel":"string"},"traktslug":{"type":"string","description":"Trakt slug.","example":"john-wick-chapter-4-2023","uniqueKey":"oneOf.0.ids.traktslug","typeLabel":"string"}},"additionalProperties":true,"example":{"simkl":53536,"imdb":"tt0181852","tmdb":"296"},"isRequired":true,"uniqueKey":"oneOf.0.ids","typeLabel":"object"},"rank":{"oneOf":[{"type":"integer","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values). Position in Simkl's popularity ranking. Null when not ranked.","uniqueKey":"oneOf.0.rank.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values). Position in Simkl's popularity ranking. Null when not ranked.","uniqueKey":"oneOf.0.rank.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.rank","typeLabel":"integer | null"},"droprate":{"oneOf":[{"type":"string","description":"Percentage of users who started watching but dropped, e.g. `\"0.1%\"`. Type 4 null when the metric isn't computed.","uniqueKey":"oneOf.0.droprate.oneOf.0","typeLabel":"string"},{"type":"null","description":"Percentage of users who started watching but dropped, e.g. `\"0.1%\"`. Type 4 null when the metric isn't computed.","uniqueKey":"oneOf.0.droprate.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.droprate","typeLabel":"string | null"},"poster":{"oneOf":[{"type":"string","description":"Poster image path. Compose the full URL via [Images](/conventions/images). Type 4 null when no poster on file.","uniqueKey":"oneOf.0.poster.oneOf.0","typeLabel":"string"},{"type":"null","description":"Poster image path. Compose the full URL via [Images](/conventions/images). Type 4 null when no poster on file.","uniqueKey":"oneOf.0.poster.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.poster","typeLabel":"string | null"},"fanart":{"oneOf":[{"type":"string","description":"Background/hero image path. Type 4 null when no fanart on file.","uniqueKey":"oneOf.0.fanart.oneOf.0","typeLabel":"string"},{"type":"null","description":"Background/hero image path. Type 4 null when no fanart on file.","uniqueKey":"oneOf.0.fanart.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.fanart","typeLabel":"string | null"},"released":{"oneOf":[{"type":"string","format":"date","description":"Initial release date (`YYYY-MM-DD`). Type 4 null when unknown.","uniqueKey":"oneOf.0.released.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Initial release date (`YYYY-MM-DD`). Type 4 null when unknown.","uniqueKey":"oneOf.0.released.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.released","typeLabel":"string\u003cdate> | null"},"runtime":{"oneOf":[{"type":"integer","description":"Runtime in minutes. Type 4 null when not on file.","uniqueKey":"oneOf.0.runtime.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Runtime in minutes. Type 4 null when not on file.","uniqueKey":"oneOf.0.runtime.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.runtime","typeLabel":"integer | null"},"director":{"oneOf":[{"type":"string","description":"Primary director. Type 4 null when unknown.","uniqueKey":"oneOf.0.director.oneOf.0","typeLabel":"string"},{"type":"null","description":"Primary director. Type 4 null when unknown.","uniqueKey":"oneOf.0.director.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.director","typeLabel":"string | null"},"certification":{"oneOf":[{"type":"string","description":"Content rating (e.g. `PG-13`, `R`). Type 4 null when not rated for the response country.","uniqueKey":"oneOf.0.certification.oneOf.0","typeLabel":"string"},{"type":"null","description":"Content rating (e.g. `PG-13`, `R`). Type 4 null when not rated for the response country.","uniqueKey":"oneOf.0.certification.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.certification","typeLabel":"string | null"},"budget":{"oneOf":[{"type":"integer","description":"Production budget in USD. Type 4 null when not on file.","uniqueKey":"oneOf.0.budget.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Production budget in USD. Type 4 null when not on file.","uniqueKey":"oneOf.0.budget.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.budget","typeLabel":"integer | null"},"revenue":{"oneOf":[{"type":"integer","description":"Box-office revenue in USD. Type 4 null when not on file.","uniqueKey":"oneOf.0.revenue.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Box-office revenue in USD. Type 4 null when not on file.","uniqueKey":"oneOf.0.revenue.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.revenue","typeLabel":"integer | null"},"overview":{"oneOf":[{"type":"string","description":"Plot synopsis. Type 4 null when no overview is available.","uniqueKey":"oneOf.0.overview.oneOf.0","typeLabel":"string"},{"type":"null","description":"Plot synopsis. Type 4 null when no overview is available.","uniqueKey":"oneOf.0.overview.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.overview","typeLabel":"string | null"},"genres":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.genres.items.[INDEX]","typeLabel":"string"},"description":"Genre names.","uniqueKey":"oneOf.0.genres","typeLabel":"string[]"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 production country code.","uniqueKey":"oneOf.0.country","typeLabel":"string"},"language":{"type":"string","description":"ISO 639-1 language code in UPPERCASE.","uniqueKey":"oneOf.0.language","typeLabel":"string"},"original_language":{"oneOf":[{"type":"string","description":"Type 4 null — no language on file for this title. See [Null and missing values](/conventions/null-values). The title's original language as a lower-case ISO 639-1 code (`en`, `ja`, `ko`) — the same field and format as `original_language` in the [trending](/api-reference/trending) and [calendar](/api-reference/calendar) files. Movies also return `language`: the same code in upper case.","example":"en","uniqueKey":"oneOf.0.original_language.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type 4 null — no language on file for this title. See [Null and missing values](/conventions/null-values). The title's original language as a lower-case ISO 639-1 code (`en`, `ja`, `ko`) — the same field and format as `original_language` in the [trending](/api-reference/trending) and [calendar](/api-reference/calendar) files. Movies also return `language`: the same code in upper case.","example":"en","uniqueKey":"oneOf.0.original_language.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.original_language","typeLabel":"string | null"},"alt_titles":{"type":"array","description":"Localized and alternate titles. May contain many entries for popular titles.","items":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"oneOf.0.alt_titles.items.[INDEX].name","typeLabel":"string"},"lang":{"type":"integer","description":"Simkl internal language code.","uniqueKey":"oneOf.0.alt_titles.items.[INDEX].lang","typeLabel":"integer"},"type":{"type":"string","enum":["official","short","synonym","original"],"description":"Classification of an entry in `alt_titles`. `official` = broadcaster/distributor-supplied localization, `short` = shortened form, `synonym` = community-supplied alias, `original` = original-language title (typically Japanese for anime).","uniqueKey":"oneOf.0.alt_titles.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.0.alt_titles.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.alt_titles","typeLabel":"object[]"},"ratings":{"type":"object","description":"Ratings keyed by source. Movies always carry `simkl` and `imdb`.","properties":{"simkl":{"type":"object","description":"External-source rating.","properties":{"rating":{"type":"number","minimum":0,"maximum":10,"description":"Rating value (0–10).","uniqueKey":"oneOf.0.ratings.simkl.rating","typeLabel":"number"},"votes":{"type":"integer","description":"Number of votes contributing to the rating.","uniqueKey":"oneOf.0.ratings.simkl.votes","typeLabel":"integer"}},"uniqueKey":"oneOf.0.ratings.simkl","typeLabel":"object"},"imdb":{"type":"object","description":"External-source rating.","properties":{"rating":{"type":"number","minimum":0,"maximum":10,"description":"Rating value (0–10).","uniqueKey":"oneOf.0.ratings.imdb.rating","typeLabel":"number"},"votes":{"type":"integer","description":"Number of votes contributing to the rating.","uniqueKey":"oneOf.0.ratings.imdb.votes","typeLabel":"integer"}},"uniqueKey":"oneOf.0.ratings.imdb","typeLabel":"object"}},"additionalProperties":{"type":"object","description":"External-source rating.","properties":{"rating":{"type":"number","minimum":0,"maximum":10,"description":"Rating value (0–10).","uniqueKey":"oneOf.0.ratings.additionalProperties.rating","typeLabel":"number"},"votes":{"type":"integer","description":"Number of votes contributing to the rating.","uniqueKey":"oneOf.0.ratings.additionalProperties.votes","typeLabel":"integer"}},"uniqueKey":"oneOf.0.ratings.additionalProperties","typeLabel":"object"},"uniqueKey":"oneOf.0.ratings","typeLabel":"object"},"trailers":{"oneOf":[{"type":"array","description":"YouTube-hosted trailers and promo clips. Type 4 null when no trailers on file. **Order:** English-language videos first, then by `type` in the order listed on that field (`trailer` first, `opening_credits` last; videos with no `type` sit right after the trailers), then largest `size` first.","items":{"type":"object","required":["youtube"],"properties":{"youtube":{"type":"string","description":"YouTube video ID (not a full URL).","isRequired":true,"uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX].youtube","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values).","uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values).","uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX].name","typeLabel":"string | null"},"size":{"oneOf":[{"type":"integer","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values). Max video resolution height (720, 1080, 2160).","uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX].size.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values). Max video resolution height (720, 1080, 2160).","uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX].size.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX].size","typeLabel":"integer | null"},"type":{"oneOf":[{"type":"string","enum":["trailer","teaser","clip","featurette","behind_the_scenes","bloopers","opening_credits",null],"description":"Type 4 null — the video has no kind on file. See [Null and missing values](/conventions/null-values). What the video is: `trailer`, `teaser`, `clip`, `featurette`, `behind_the_scenes`, `bloopers` or `opening_credits`. Filter on it to show trailers only, or to group extras by kind.","example":"trailer","uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX].type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["trailer","teaser","clip","featurette","behind_the_scenes","bloopers","opening_credits",null],"description":"Type 4 null — the video has no kind on file. See [Null and missing values](/conventions/null-values). What the video is: `trailer`, `teaser`, `clip`, `featurette`, `behind_the_scenes`, `bloopers` or `opening_credits`. Filter on it to show trailers only, or to group extras by kind.","example":"trailer","uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX].type","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"oneOf.0.trailers.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.trailers.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"YouTube-hosted trailers and promo clips. Type 4 null when no trailers on file. **Order:** English-language videos first, then by `type` in the order listed on that field (`trailer` first, `opening_credits` last; videos with no `type` sit right after the trailers), then largest `size` first.","items":{"type":"object","required":["youtube"],"properties":{"name":{"oneOf":[{"type":"string","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values)."},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values)."}]},"youtube":{"type":"string","description":"YouTube video ID (not a full URL)."},"size":{"oneOf":[{"type":"integer","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values). Max video resolution height (720, 1080, 2160)."},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values). Max video resolution height (720, 1080, 2160)."}]},"type":{"oneOf":[{"type":"string","enum":["trailer","teaser","clip","featurette","behind_the_scenes","bloopers","opening_credits",null],"description":"Type 4 null — the video has no kind on file. See [Null and missing values](/conventions/null-values). What the video is: `trailer`, `teaser`, `clip`, `featurette`, `behind_the_scenes`, `bloopers` or `opening_credits`. Filter on it to show trailers only, or to group extras by kind.","example":"trailer"},{"type":"null","enum":["trailer","teaser","clip","featurette","behind_the_scenes","bloopers","opening_credits",null],"description":"Type 4 null — the video has no kind on file. See [Null and missing values](/conventions/null-values). What the video is: `trailer`, `teaser`, `clip`, `featurette`, `behind_the_scenes`, `bloopers` or `opening_credits`. Filter on it to show trailers only, or to group extras by kind.","example":"trailer"}]}}},"uniqueKey":"oneOf.0.trailers.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.trailers","typeLabel":"object[] | null"},"release_dates":{"type":"array","description":"Per-country release event timeline.","items":{"type":"object","required":["iso_3166_1","results"],"properties":{"iso_3166_1":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","isRequired":true,"uniqueKey":"oneOf.0.release_dates.items.[INDEX].iso_3166_1","typeLabel":"string"},"results":{"type":"array","items":{"type":"object","required":["type","release_date"],"properties":{"type":{"type":"integer","description":"Release-event type: 1 = premiere, 2 = theatrical limited, 3 = theatrical wide, 4 = digital, 5 = physical, 6 = TV.","isRequired":true,"uniqueKey":"oneOf.0.release_dates.items.[INDEX].results.items.[INDEX].type","typeLabel":"integer"},"release_date":{"type":"string","format":"date","isRequired":true,"uniqueKey":"oneOf.0.release_dates.items.[INDEX].results.items.[INDEX].release_date","typeLabel":"string\u003cdate>"}},"uniqueKey":"oneOf.0.release_dates.items.[INDEX].results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.release_dates.items.[INDEX].results","typeLabel":"object[]"}},"uniqueKey":"oneOf.0.release_dates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.release_dates","typeLabel":"object[]"},"users_recommendations":{"type":"array","description":"Mini media objects suggested by Simkl based on this title's viewers.","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].title","typeLabel":"string"},"year":{"oneOf":[{"type":"integer","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values).","uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].year.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values).","uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].year.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].year","typeLabel":"integer | null"},"poster":{"oneOf":[{"type":"string","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values).","uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].poster.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values).","uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].poster.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].poster","typeLabel":"string | null"},"fanart":{"oneOf":[{"type":"string","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values). Background image path, same format as `poster`.","uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].fanart.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values). Background image path, same format as `poster`.","uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].fanart.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].fanart","typeLabel":"string | null"},"type":{"type":"string","uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].type","typeLabel":"string"},"ids":{"type":"object","properties":{"simkl":{"type":"integer","uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].ids.simkl","typeLabel":"integer"},"slug":{"type":"string","uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].ids.slug","typeLabel":"string"}},"uniqueKey":"oneOf.0.users_recommendations.items.[INDEX].ids","typeLabel":"object"}},"uniqueKey":"oneOf.0.users_recommendations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.users_recommendations","typeLabel":"object[]"},"similar":{"type":"array","description":"Titles in the same genres — the strip shown at the bottom of this title's page on simkl.com. Unlike `users_recommendations`, it is based on genre rather than on what this title's viewers watched, so it carries no `users_percent` or `users_count`.\n\n**Type 2 — omitted entirely** when there is nothing to show, rather than returned as an empty array. See [Null and missing values](/conventions/null-values#type-2).","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"oneOf.0.similar.items.[INDEX].title","typeLabel":"string"},"year":{"oneOf":[{"type":"integer","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values).","uniqueKey":"oneOf.0.similar.items.[INDEX].year.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values).","uniqueKey":"oneOf.0.similar.items.[INDEX].year.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.similar.items.[INDEX].year","typeLabel":"integer | null"},"poster":{"oneOf":[{"type":"string","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values).","uniqueKey":"oneOf.0.similar.items.[INDEX].poster.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values).","uniqueKey":"oneOf.0.similar.items.[INDEX].poster.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.similar.items.[INDEX].poster","typeLabel":"string | null"},"fanart":{"oneOf":[{"type":"string","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values). Background image path, same format as `poster`.","uniqueKey":"oneOf.0.similar.items.[INDEX].fanart.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type 4 null — data not on file in that field's slot. See [Null and missing values](/conventions/null-values). Background image path, same format as `poster`.","uniqueKey":"oneOf.0.similar.items.[INDEX].fanart.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.similar.items.[INDEX].fanart","typeLabel":"string | null"},"type":{"type":"string","description":"`movie`, `tv` or `anime`. Can differ from this title's own type.","uniqueKey":"oneOf.0.similar.items.[INDEX].type","typeLabel":"string"},"ids":{"type":"object","description":"External and internal identifiers for an item. Pass as many as you have — Simkl resolves to the canonical record.","properties":{"simkl":{"type":"integer","description":"Simkl internal ID. Most reliable.","example":53536,"uniqueKey":"oneOf.0.similar.items.[INDEX].ids.simkl","typeLabel":"integer"},"slug":{"type":"string","description":"URL-safe slug returned in responses.","example":"attack-on-titan","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.slug","typeLabel":"string"},"imdb":{"type":"string","description":"IMDb ID.","example":"tt0181852","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.imdb","typeLabel":"string"},"tmdb":{"type":"string","description":"TMDb ID.","example":"296","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.tmdb","typeLabel":"string"},"tvdb":{"description":"TVDB ID or slug.","example":"153021","type":"string","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.tvdb","typeLabel":"string"},"mal":{"type":"string","description":"MyAnimeList ID.","example":"4246","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.mal","typeLabel":"string"},"anidb":{"type":"string","description":"AniDB ID. Specifying just this is enough for anime lookups.","example":"10846","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.anidb","typeLabel":"string"},"anilist":{"type":"string","description":"AniList ID.","example":"21","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.anilist","typeLabel":"string"},"kitsu":{"type":"string","description":"Kitsu ID.","example":"12","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.kitsu","typeLabel":"string"},"anisearch":{"type":"string","description":"aniSearch ID.","example":"2227","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.anisearch","typeLabel":"string"},"animeplanet":{"type":"string","description":"Anime-Planet slug.","example":"one-piece","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.animeplanet","typeLabel":"string"},"livechart":{"type":"string","description":"LiveChart ID.","example":"321","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.livechart","typeLabel":"string"},"letterboxd":{"type":"string","description":"Letterboxd slug.","example":"the-truman-show","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.letterboxd","typeLabel":"string"},"netflix":{"type":"string","description":"Netflix movie ID.","example":"70210890","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.netflix","typeLabel":"string"},"hulu":{"type":"string","description":"Hulu episode ID.","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.hulu","typeLabel":"string"},"crunchyroll":{"type":"string","description":"Crunchyroll episode ID.","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.crunchyroll","typeLabel":"string"},"traktslug":{"type":"string","description":"Trakt slug.","example":"john-wick-chapter-4-2023","uniqueKey":"oneOf.0.similar.items.[INDEX].ids.traktslug","typeLabel":"string"}},"additionalProperties":true,"example":{"simkl":53536,"imdb":"tt0181852","tmdb":"296"},"uniqueKey":"oneOf.0.similar.items.[INDEX].ids","typeLabel":"object"}},"uniqueKey":"oneOf.0.similar.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.similar","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"oneOf.1.items.[INDEX]","typeLabel":"any"},"title":"Empty (unknown Simkl ID)","description":"Empty array `[]` — see `unknown_id_empty` example below.","maxItems":0,"uniqueKey":"oneOf.1","typeLabel":"any[]"}],"uniqueKey":"","typeLabel":"object | any[]"},"examples":{"inception":{"title":"inception","summary":"Modern blockbuster (Inception, simkl 472214)","description":"With `extended=full`: alt titles, budget and revenue, release dates by country, trailers, similar titles and user recommendations. `ids` carries the IDs Simkl maps for the title — external sites only, no social-media handles. `alt_titles` shortened to two.","value":{"title":"Inception","year":2010,"type":"movie","ids":{"simkl":472214,"slug":"inception","tmdb":"27205","imdb":"tt1375666","tvdb":"113","tvdbslug":"inception","traktslug":"inception-2010","letterboxd":"inception"},"rank":20,"droprate":"0.1%","poster":"13/134621776735ba40e1","fanart":"12/12560139622dc9c7e6","released":"2010-07-15","runtime":148,"director":"Christopher Nolan","certification":"PG-13","budget":160000000,"revenue":839030630,"overview":"Cobb, a skilled thief who commits corporate espionage by infiltrating the subconscious of his targets is offered a chance to regain his old life as payment for a task considered to be impossible: \"inception\", the implantation of another person's idea into a target's subconscious.","genres":["Action","Adventure","Crime","Science Fiction","Thriller"],"country":"US","language":"EN","original_language":"en","alt_titles":[{"name":"Начало","lang":22,"type":"official"},{"name":"Початок","lang":31,"type":"official"}],"ratings":{"simkl":{"rating":8.6,"votes":15265},"imdb":{"rating":8.8,"votes":2889060}},"trailers":[{"name":"35mm Theatrical Trailer #3","youtube":"cdx31ak4KbQ","size":2160,"type":"trailer"},{"name":"Official New UK Trailer","youtube":"JE9z-gy4De4","size":1080,"type":"trailer"},{"name":"Official Trailer","youtube":"Jvurpf91omw","size":1080,"type":"trailer"},{"name":"Official UK Teaser Trailer","youtube":"hstBN0Qkqhc","size":1080,"type":"teaser"},{"name":"IMAX® TV Spot","youtube":"uwyJfuM-ViA","size":1080,"type":"teaser"},{"name":"TV Spot","youtube":"cG_i7xnkMu8","size":720,"type":"teaser"},{"name":"TV Spot #1","youtube":"7aED7XBmbyQ","size":720,"type":"teaser"},{"name":"TV Spot #2","youtube":"J4BnDN7A-pk","size":720,"type":"teaser"},{"name":"TV Spot #3","youtube":"RDgRNxSm53o","size":720,"type":"teaser"},{"name":"TV Spot #4","youtube":"sn8JQgjSr7k","size":720,"type":"teaser"},{"name":"TV Spot #5","youtube":"8jRd8qRcaLI","size":720,"type":"teaser"},{"name":"TV Spot #6","youtube":"8XjKtoTFuLo","size":720,"type":"teaser"},{"name":"TV Spot #7","youtube":"niw40pVKctc","size":720,"type":"teaser"},{"name":"TV Spot #8","youtube":"CJXn7hNtblE","size":720,"type":"teaser"},{"name":"TV Spot #9","youtube":"HO5v3RhO8ek","size":720,"type":"teaser"},{"name":"The Final Scene","youtube":"k5DTbekB86s","size":720,"type":"clip"},{"name":"The Dream Sequence","youtube":"mpj9dL7swwk","size":720,"type":"clip"},{"name":"Characters","youtube":"hW0M4xXxqpw","size":1080,"type":"featurette"},{"name":"IMAX® Presents: Inception's Christopher Nolan","youtube":"fn6vJ8WPpvw","size":1080,"type":"featurette"},{"name":"Michael Caine explains the ending of Inception at Film4 Summer Screen","youtube":"Ms56yWZak9w","size":1080,"type":"featurette"},{"name":"Christopher Nolan \u0026 Leonardo DiCaprio on Inception | Film4 Interview Special Archives","youtube":"SBmxYERafeU","size":1080,"type":"featurette"},{"name":"\"Inception\" winning the Oscar® for Visual Effects","youtube":"rTWI33cOMF0","size":720,"type":"featurette"},{"name":"\"Inception\" winning Best Cinematography","youtube":"aRDEd1BAdc8","size":720,"type":"featurette"},{"name":"\"Inception\" winning the Oscar® for Sound Mixing","youtube":"if_IcKvxBDA","size":720,"type":"featurette"},{"name":"\"Inception\" winning the Oscar® for Sound Editing","youtube":"54Od-ZJHox0","size":720,"type":"featurette"},{"name":"An Extended Special Look","youtube":"Fl7KyyKqqhE","size":1080,"type":"behind_the_scenes"},{"name":"8 Academy Award® Nominations","youtube":"Cc8p-dqF1LU","size":720,"type":"behind_the_scenes"}],"release_dates":[{"iso_3166_1":"AE","results":[{"type":3,"release_date":"2010-07-15"},{"type":4,"release_date":"2020-08-13"}]},{"iso_3166_1":"AM","results":[{"type":3,"release_date":"2010-08-10"}]},{"iso_3166_1":"AR","results":[{"type":3,"release_date":"2010-07-29"},{"type":1,"release_date":"2010-07-26"}]},{"iso_3166_1":"AT","results":[{"type":3,"release_date":"2010-07-29"}]},{"iso_3166_1":"AU","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"BA","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"BE","results":[{"type":3,"release_date":"2010-07-21"}]},{"iso_3166_1":"BG","results":[{"type":3,"release_date":"2010-07-23"}]},{"iso_3166_1":"BO","results":[{"type":3,"release_date":"2010-08-05"}]},{"iso_3166_1":"BR","results":[{"type":3,"release_date":"2010-08-06"},{"type":5,"release_date":"2010-12-09"}]},{"iso_3166_1":"CA","results":[{"type":3,"release_date":"2010-07-16"}]},{"iso_3166_1":"CH","results":[{"type":3,"release_date":"2010-07-21"}]},{"iso_3166_1":"CL","results":[{"type":3,"release_date":"2010-08-12"}]},{"iso_3166_1":"CN","results":[{"type":3,"release_date":"2010-09-01"},{"type":1,"release_date":"2026-11-15"}]},{"iso_3166_1":"CO","results":[{"type":3,"release_date":"2010-08-06"}]},{"iso_3166_1":"CZ","results":[{"type":3,"release_date":"2010-07-29"}]},{"iso_3166_1":"DE","results":[{"type":3,"release_date":"2010-07-29"},{"type":5,"release_date":"2010-12-03"}]},{"iso_3166_1":"DK","results":[{"type":3,"release_date":"2010-07-29"}]},{"iso_3166_1":"EC","results":[{"type":3,"release_date":"2010-08-06"}]},{"iso_3166_1":"EE","results":[{"type":3,"release_date":"2010-07-23"}]},{"iso_3166_1":"EG","results":[{"type":3,"release_date":"2010-07-17"}]},{"iso_3166_1":"ES","results":[{"type":3,"release_date":"2010-08-06"}]},{"iso_3166_1":"FI","results":[{"type":3,"release_date":"2010-07-23"}]},{"iso_3166_1":"FR","results":[{"type":3,"release_date":"2010-07-21"},{"type":6,"release_date":"2013-04-07"}]},{"iso_3166_1":"GB","results":[{"type":3,"release_date":"2010-07-16"},{"type":1,"release_date":"2010-07-08"}]},{"iso_3166_1":"GE","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"GH","results":[{"type":3,"release_date":"2010-07-30"}]},{"iso_3166_1":"GR","results":[{"type":3,"release_date":"2010-08-24"}]},{"iso_3166_1":"HK","results":[{"type":3,"release_date":"2010-07-29"}]},{"iso_3166_1":"HR","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"HU","results":[{"type":3,"release_date":"2010-07-22"},{"type":5,"release_date":"2010-12-07"}]},{"iso_3166_1":"ID","results":[{"type":3,"release_date":"2010-07-16"}]},{"iso_3166_1":"IE","results":[{"type":3,"release_date":"2010-07-16"}]},{"iso_3166_1":"IL","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"IN","results":[{"type":3,"release_date":"2010-07-16"}]},{"iso_3166_1":"IS","results":[{"type":3,"release_date":"2010-07-23"}]},{"iso_3166_1":"IT","results":[{"type":3,"release_date":"2010-09-24"}]},{"iso_3166_1":"JP","results":[{"type":3,"release_date":"2010-07-23"},{"type":2,"release_date":"2010-07-17"}]},{"iso_3166_1":"KR","results":[{"type":3,"release_date":"2010-07-21"}]},{"iso_3166_1":"KW","results":[{"type":3,"release_date":"2010-07-15"}]},{"iso_3166_1":"KZ","results":[{"type":3,"release_date":"2010-07-16"}]},{"iso_3166_1":"LB","results":[{"type":3,"release_date":"2010-07-29"}]},{"iso_3166_1":"LT","results":[{"type":3,"release_date":"2010-07-23"}]},{"iso_3166_1":"LV","results":[{"type":3,"release_date":"2010-07-30"}]},{"iso_3166_1":"MT","results":[{"type":3,"release_date":"2010-07-21"}]},{"iso_3166_1":"MX","results":[{"type":3,"release_date":"2010-07-23"},{"type":2,"release_date":"2020-08-27"}]},{"iso_3166_1":"MY","results":[{"type":3,"release_date":"2010-07-15"}]},{"iso_3166_1":"NG","results":[{"type":3,"release_date":"2010-07-30"}]},{"iso_3166_1":"NL","results":[{"type":3,"release_date":"2010-07-22"},{"type":6,"release_date":"2013-03-04"},{"type":5,"release_date":"2010-12-03"}]},{"iso_3166_1":"NO","results":[{"type":3,"release_date":"2010-07-21"}]},{"iso_3166_1":"NZ","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"PA","results":[{"type":3,"release_date":"2010-08-06"}]},{"iso_3166_1":"PE","results":[{"type":3,"release_date":"2010-07-29"}]},{"iso_3166_1":"PH","results":[{"type":3,"release_date":"2010-07-15"},{"type":4,"release_date":"2026-11-05"}]},{"iso_3166_1":"PK","results":[{"type":3,"release_date":"2010-09-11"}]},{"iso_3166_1":"PL","results":[{"type":3,"release_date":"2010-07-30"}]},{"iso_3166_1":"PT","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"RO","results":[{"type":3,"release_date":"2010-07-30"}]},{"iso_3166_1":"RS","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"RU","results":[{"type":3,"release_date":"2010-07-22"},{"type":5,"release_date":"2010-12-07"}]},{"iso_3166_1":"SE","results":[{"type":3,"release_date":"2010-07-23"},{"type":5,"release_date":"2010-12-08"}]},{"iso_3166_1":"SG","results":[{"type":3,"release_date":"2010-07-15"}]},{"iso_3166_1":"SI","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"SK","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"SY","results":[{"type":3,"release_date":"2010-07-15"}]},{"iso_3166_1":"TH","results":[{"type":3,"release_date":"2010-07-15"}]},{"iso_3166_1":"TR","results":[{"type":3,"release_date":"2010-07-30"}]},{"iso_3166_1":"TW","results":[{"type":3,"release_date":"2010-07-16"}]},{"iso_3166_1":"UA","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"US","results":[{"type":5,"release_date":"2010-12-07"},{"type":3,"release_date":"2010-07-16"},{"type":1,"release_date":"2010-07-13"}]},{"iso_3166_1":"UY","results":[{"type":3,"release_date":"2010-07-30"}]},{"iso_3166_1":"UZ","results":[{"type":3,"release_date":"2010-07-22"}]},{"iso_3166_1":"VE","results":[{"type":3,"release_date":"2010-08-06"}]},{"iso_3166_1":"VN","results":[{"type":3,"release_date":"2010-08-06"}]},{"iso_3166_1":"ZA","results":[{"type":3,"release_date":"2010-07-30"},{"type":2,"release_date":"2025-03-14"}]}],"users_recommendations":[{"title":"Interstellar","year":2014,"poster":"20/2052598c2716ef054","fanart":"15/15255183c8d12b92a6","type":"movie","ids":{"simkl":250822,"slug":"interstellar","imdb":"tt0816692","tmdb":"157336","tvdb":"131079","tvdbslug":"interstellar","traktslug":"interstellar-2014","letterboxd":"interstellar"}},{"title":"The Dark Knight","year":2008,"poster":"78/78195185129f87e6a","fanart":"78/782975022baaa29d9","type":"movie","ids":{"simkl":53282,"slug":"the-dark-knight","imdb":"tt0468569","tmdb":"155","tvdb":"116","tvdbslug":"the-dark-knight","traktslug":"the-dark-knight-2008","letterboxd":"the-dark-knight"}},{"title":"The Matrix","year":1999,"poster":"80/8008234e702d8ed33","fanart":"12/12560269d5c490d440","type":"movie","ids":{"simkl":53992,"slug":"the-matrix","imdb":"tt0133093","tmdb":"603","tvdb":"169","tvdbslug":"the-matrix","traktslug":"the-matrix-1999","letterboxd":"the-matrix"}},{"title":"Django Unchained","year":2012,"poster":"96/964479262c48c8a5e","fanart":"93/9380106bf729e028e","type":"movie","ids":{"simkl":149872,"slug":"django-unchained","imdb":"tt1853728","tmdb":"68718","tvdb":"289","tvdbslug":"django-unchained","traktslug":"django-unchained-2012","letterboxd":"django-unchained"}},{"title":"Shutter Island","year":2010,"poster":"68/6867088e17d089ff2","fanart":"10/10154142037c36afa3","type":"movie","ids":{"simkl":65582,"slug":"shutter-island","imdb":"tt1130884","tmdb":"11324","tvdb":"558","tvdbslug":"shutter-island","traktslug":"shutter-island-2010","letterboxd":"shutter-island"}},{"title":"The Wolf of Wall Street","year":2013,"poster":"16/1694116127882f3c7c","fanart":"13/13203487c2e98dd076","type":"movie","ids":{"simkl":199692,"slug":"the-wolf-of-wall-street","imdb":"tt0993846","tmdb":"106646","tvdb":"389","tvdbslug":"the-wolf-of-wall-street","traktslug":"the-wolf-of-wall-street-2013","letterboxd":"the-wolf-of-wall-street"}},{"title":"The Dark Knight Rises","year":2012,"poster":"95/9529508f1dd6603c1","fanart":"12/127483830b8a2c6c74","type":"movie","ids":{"simkl":118654,"slug":"the-dark-knight-rises","imdb":"tt1345836","tmdb":"49026","tvdb":"222","tvdbslug":"the-dark-knight-rises","traktslug":"the-dark-knight-rises-2012","letterboxd":"the-dark-knight-rises"}},{"title":"The Departed","year":2006,"poster":"13/13674473e46f95cdd4","fanart":"13/13674477bfedaad250","type":"movie","ids":{"simkl":54902,"slug":"the-departed","imdb":"tt0407887","tmdb":"1422","tvdb":"590","tvdbslug":"the-departed","traktslug":"the-departed-2006","letterboxd":"the-departed"}},{"title":"Batman Begins","year":2005,"poster":"13/13811455ee24844ab8","fanart":"16/167477698f0a2d2cec","type":"movie","ids":{"simkl":53494,"slug":"batman-begins","imdb":"tt0372784","tmdb":"272","tvdb":"293","tvdbslug":"batman-begins","traktslug":"batman-begins-2005","letterboxd":"batman-begins"}},{"title":"Memento","year":2000,"poster":"13/1307188122ff3ea5c9","fanart":"98/9867536dba6ba9cfd","type":"movie","ids":{"simkl":53150,"slug":"memento","imdb":"tt0209144","tmdb":"77","tvdb":"434","tvdbslug":"memento","traktslug":"memento-2000","letterboxd":"memento"}},{"title":"Oppenheimer","year":2023,"poster":"14/14014845db161c4cea","fanart":"15/154793092fcd31e5db","type":"movie","ids":{"simkl":1727566,"slug":"oppenheimer","imdb":"tt15398776","tmdb":"872585","tvdb":"287533","tvdbslug":"oppenheimer","traktslug":"oppenheimer-2023","letterboxd":"oppenheimer-2023"}},{"title":"Avengers: Endgame","year":2019,"poster":"78/7850544702b693f1f","fanart":"79/7922916510630165a","type":"movie","ids":{"simkl":430306,"slug":"avengers-endgame","imdb":"tt4154796","tmdb":"299534","tvdb":"148","tvdbslug":"avengers-endgame","traktslug":"avengers-endgame-2019","letterboxd":"avengers-endgame"}}],"similar":[{"title":"Criminal","year":2016,"poster":"18/184901594aee93759c","fanart":"20/207140332b362f6b43","type":"movie","ids":{"simkl":434118,"slug":"criminal","imdb":"tt3014866","tmdb":"302156","tvdb":"1998","tvdbslug":"criminal","traktslug":"criminal-2016","letterboxd":"criminal-2016"}},{"title":"Ballistic: Ecks vs. Sever","year":2002,"poster":"54/54657848b24cfff10","fanart":"10/10281560c44aadf9a8","type":"movie","ids":{"simkl":64226,"slug":"ballistic-ecks-vs-sever","imdb":"tt0308208","tmdb":"10550","tvdb":"3628","tvdbslug":"ballistic-ecks-vs-sever","traktslug":"ballistic-ecks-vs-sever-2002","letterboxd":"ballistic-ecks-vs-sever"}},{"title":"Justice League Dark","year":2017,"poster":"10/10158536286812aeb4","fanart":"67/6732282a1c507af72","type":"movie","ids":{"simkl":603620,"slug":"justice-league-dark","imdb":"tt2494376","tmdb":"408220","tvdb":"4964","tvdbslug":"justice-league-dark","traktslug":"justice-league-dark-2017","letterboxd":"justice-league-dark"}},{"title":"Justice League vs. Teen Titans","year":2016,"poster":"11/11926250e7cdb54de9","fanart":"67/67319747eeecc1efb","type":"movie","ids":{"simkl":554218,"slug":"justice-league-vs-teen-titans","imdb":"tt5091548","tmdb":"379291","tvdb":"6898","tvdbslug":"justice-league-vs-teen-titans","traktslug":"justice-league-vs-teen-titans-2016","letterboxd":"justice-league-vs-teen-titans"}},{"title":"Redux Redux","year":2025,"poster":"19/19486495cb27e71252","fanart":"19/19486505f33f82a3a5","type":"movie","ids":{"simkl":2558831,"slug":"redux-redux","imdb":"tt33295741","tmdb":"1340110","tvdb":"372238","tvdbslug":"redux-redux","traktslug":"redux-redux-2025","letterboxd":"redux-redux"}},{"title":"Deathstroke: Knights \u0026 Dragons - The Movie","year":2020,"poster":"10/10148658c2c5ed0fa3","fanart":"10/101486628a7cf09236","type":"movie","ids":{"simkl":1346586,"slug":"deathstroke-knights-and-dragons---the-movie","imdb":"tt12876132","tmdb":"703771","tvdb":"138227","tvdbslug":"deathstroke-knights-dragons","traktslug":"deathstroke-knights-dragons-the-movie-2020","letterboxd":"deathstroke-knights-dragons-the-movie"}},{"title":"Venom: Let There Be Carnage","year":2021,"poster":"12/12732067f38bf4f342","fanart":"11/11929640d7b99f3a8b","type":"movie","ids":{"simkl":1036398,"slug":"venom-let-there-be-carnage","imdb":"tt7097896","tmdb":"580489","tvdb":"17104","tvdbslug":"venom-2","traktslug":"venom-let-there-be-carnage-2021","letterboxd":"venom-let-there-be-carnage"}},{"title":"Tokyo Gore Police","year":2008,"poster":"15/157027634f27d99218","fanart":"16/1613762712f1238094","type":"movie","ids":{"simkl":563334,"slug":"tokyo-gore-police","imdb":"tt1183732","mdlslug":"2434-tokyo-gore-police","tmdb":"16061","tvdb":"9836","tvdbslug":"tokyo-gore-police","traktslug":"tokyo-gore-police-2008","letterboxd":"tokyo-gore-police"}},{"title":"See You Yesterday","year":2019,"poster":"81/8106922ff058e2af2","fanart":"84/843506258b008626a","type":"movie","ids":{"simkl":1044168,"slug":"see-you-yesterday","imdb":"tt8743064","tmdb":"582607","tvdb":"131406","tvdbslug":"see-you-yesterday","traktslug":"see-you-yesterday-2019","letterboxd":"see-you-yesterday-2019"}}]}},"classic_godfather":{"title":"classic_godfather","summary":"Classic film, default shape (The Godfather, simkl 53434)","description":"Without `extended=full` the record is shorter — no overview, alt titles, trailers or similar titles.","value":{"title":"The Godfather","year":1972,"type":"movie","ids":{"simkl":53434,"slug":"the-godfather","tmdb":"238","imdb":"tt0068646","tvdb":"275","tvdbslug":"the-godfather","traktslug":"the-godfather-1972","letterboxd":"the-godfather"},"rank":2,"droprate":"0.4%","poster":"10/1024475455baeffd1f","fanart":"18/18996895ae47684306","released":"1972-03-14","runtime":175,"director":"Francis Ford Coppola","certification":"R","budget":6000000,"revenue":245066411,"overview":"Spanning the years 1945 to 1955, a chronicle of the fictional Italian-American Corleone crime family. When organized crime family patriarch, Vito Corleone barely survives an attempt on his life, his youngest son, Michael steps in to take care of the would-be killers, launching a campaign of bloody revenge.","genres":["Crime","Drama"],"country":"US","language":"EN","original_language":"en","alt_titles":[{"name":"Крёстный отец","lang":22,"type":"official"},{"name":"El Padrino","lang":16,"type":"official"}],"ratings":{"simkl":{"rating":8.8,"votes":7515},"imdb":{"rating":9.2,"votes":2272133}},"trailers":[{"name":"50th Anniversary Trailer","youtube":"Ew9ngL1GZvs","size":2160,"type":"trailer"},{"name":"Original Trailer","youtube":"8V2k2YQEQJ4","size":1080,"type":"trailer"},{"name":"45th Anniversary Spot","youtube":"gMjmsqvIPGc","size":720,"type":"teaser"},{"name":"Offer He Can't Refuse","youtube":"fBNpSRtfIUA","size":1080,"type":"clip"},{"name":"\"Sleep With The Fishes\" Clip","youtube":"HsRvgCsLXWw","size":1080,"type":"clip"},{"name":"Opening Scene","youtube":"eZHsmb4ezEk","size":1080,"type":"clip"},{"name":"\"Don Vito and Michael Corleone\" Clip","youtube":"7IXVycNgGN0","size":1080,"type":"clip"},{"name":"Don Corleone Gets Shot","youtube":"evl5ai7Mg7w","size":1080,"type":"clip"},{"name":"🚩 Remembering DIANE KEATON in THE GODFATHER (1972)","youtube":"K1IXrOF5w3Y","size":720,"type":"clip"},{"name":"Mario Puzo on the baptism scene in THE GODFATHER","youtube":"CG5kZcWj1mE","size":1080,"type":"featurette"},{"name":"Sacheen Littlefeather Reads Marlon Brando’s Full 1973 Oscars® Speech","youtube":"d0PViD48uO8","size":1080,"type":"featurette"},{"name":"The Art of Moviemaking: The Godfather | Academy Conversations","youtube":"1cdrtPIzjII","size":1080,"type":"featurette"},{"name":"Tom Hanks on Brando's Iconic \"Godfather\" Look","youtube":"GiZVLFvQruQ","size":1080,"type":"featurette"},{"name":"Makeup Techniques: THE GODFATHER","youtube":"bPOj-ZTQG-M","size":1080,"type":"featurette"},{"name":"Elemack Spyder Dolly: THE GODFATHER","youtube":"j3Fr15ix_TA","size":1080,"type":"featurette"},{"name":"Why This One Shot in ‘The Godfather’ Suddenly Feels Terrifying!","youtube":"kbKCCV2EAqo","size":1080,"type":"featurette"},{"name":"Ray Romano announces THE GODFATHER for AFI Movie Club","youtube":"JxiteCBugh8","size":720,"type":"featurette"},{"name":"Al Pacino’s Audition Tape for The Godfather","youtube":"E7CMIhJiTXY","size":720,"type":"featurette"},{"name":"Marlon Brando's Best Actor Oscar win for \"The Godfather\" | Sacheen Littlefeather","youtube":"2QUacU0I4yU","size":480,"type":"featurette"},{"name":"Francis Ford Coppola On Casting Al Pacino in THE GODFATHER","youtube":"67Fg3xmvJyA","size":480,"type":"featurette"},{"name":"Sidney Lumet On THE GODFATHER","youtube":"0Hl_mdNgjpY","size":480,"type":"featurette"},{"name":"William Friedkin on THE GODFATHER","youtube":"F1L3Tz0Im_8","size":480,"type":"featurette"},{"name":"The Godfather Wins Best Picture: 45th Oscars (1973)","youtube":"Y1qWRdil--A","size":480,"type":"featurette"},{"name":"Sydney Pollack on THE GODFATHER","youtube":"-lBTgBqGA-g","size":480,"type":"featurette"},{"name":"The Godfather and The Candidate Win Writing Awards: 1973 Oscars","youtube":"M3GhqH7QmcA","size":480,"type":"featurette"},{"name":"Robert De Niro Auditioning for Sonny Corleone in The Godfather","youtube":"tlFyyzXVEMk","size":720,"type":"behind_the_scenes"}],"release_dates":[{"iso_3166_1":"AR","results":[{"type":3,"release_date":"1972-09-20"}]},{"iso_3166_1":"AU","results":[{"type":3,"release_date":"1972-11-02"}]},{"iso_3166_1":"BE","results":[{"type":2,"release_date":"1972-03-14"}]},{"iso_3166_1":"BR","results":[{"type":5,"release_date":"2000-12-07"},{"type":3,"release_date":"1972-07-07"}]},{"iso_3166_1":"CA","results":[{"type":3,"release_date":"1972-03-14"}]},{"iso_3166_1":"CZ","results":[{"type":5,"release_date":"1994-09-01"}]},{"iso_3166_1":"DE","results":[{"type":3,"release_date":"1972-08-24"},{"type":5,"release_date":"2001-07-22"},{"type":4,"release_date":"2026-09-13"},{"type":6,"release_date":"2026-09-13"}]},{"iso_3166_1":"DK","results":[{"type":3,"release_date":"1972-12-26"}]},{"iso_3166_1":"EE","results":[{"type":2,"release_date":"2022-03-14"}]},{"iso_3166_1":"ES","results":[{"type":3,"release_date":"1972-10-20"}]},{"iso_3166_1":"FI","results":[{"type":3,"release_date":"1972-09-29"}]},{"iso_3166_1":"FR","results":[{"type":3,"release_date":"1972-10-18"},{"type":2,"release_date":"2022-02-25"},{"type":4,"release_date":"2017-12-27"},{"type":5,"release_date":"1997-11-20"},{"type":6,"release_date":"2026-09-13"}]},{"iso_3166_1":"GB","results":[{"type":3,"release_date":"1972-08-24"},{"type":5,"release_date":"2001-10-09"}]},{"iso_3166_1":"GR","results":[{"type":3,"release_date":"1972-09-29"},{"type":4,"release_date":"2016-06-30"}]},{"iso_3166_1":"HK","results":[{"type":3,"release_date":"1980-01-24"}]},{"iso_3166_1":"HU","results":[{"type":3,"release_date":"1982-03-25"}]},{"iso_3166_1":"ID","results":[{"type":4,"release_date":"2024-11-22"}]},{"iso_3166_1":"IE","results":[{"type":3,"release_date":"1972-08-25"}]},{"iso_3166_1":"IN","results":[{"type":3,"release_date":"2025-09-12"}]},{"iso_3166_1":"IT","results":[{"type":3,"release_date":"1972-09-21"}]},{"iso_3166_1":"JP","results":[{"type":3,"release_date":"1972-07-15"},{"type":2,"release_date":"2016-06-30"}]},{"iso_3166_1":"KR","results":[{"type":3,"release_date":"1972-12-27"}]},{"iso_3166_1":"MX","results":[{"type":3,"release_date":"1998-08-14"}]},{"iso_3166_1":"NL","results":[{"type":3,"release_date":"1973-01-18"},{"type":5,"release_date":"2008-01-14"}]},{"iso_3166_1":"NO","results":[{"type":3,"release_date":"1972-10-16"},{"type":5,"release_date":"2010-02-09"}]},{"iso_3166_1":"PL","results":[{"type":3,"release_date":"1972-12-31"}]},{"iso_3166_1":"PT","results":[{"type":3,"release_date":"1972-10-24"},{"type":2,"release_date":"1974-05-11"}]},{"iso_3166_1":"SE","results":[{"type":3,"release_date":"1972-09-27"}]},{"iso_3166_1":"SG","results":[{"type":2,"release_date":"2022-02-25"}]},{"iso_3166_1":"TH","results":[{"type":2,"release_date":"2022-02-25"}]},{"iso_3166_1":"TR","results":[{"type":3,"release_date":"1973-10-19"}]},{"iso_3166_1":"US","results":[{"type":5,"release_date":"2022-03-22"},{"type":3,"release_date":"1972-03-24"},{"type":1,"release_date":"1972-03-14"}]},{"iso_3166_1":"UY","results":[{"type":3,"release_date":"1972-08-10"}]}],"users_recommendations":[{"title":"The Godfather Part II","year":1974,"poster":"14/145610937a55e3bf40","fanart":"12/12918211b762697aab","type":"movie","ids":{"simkl":53438,"slug":"the-godfather-part-ii","imdb":"tt0071562","tmdb":"240","tvdb":"780","tvdbslug":"the-godfather-part-ii","traktslug":"the-godfather-part-ii-1974","letterboxd":"the-godfather-part-ii"}},{"title":"Pulp Fiction","year":1994,"poster":"13/13311405613660dcc9","fanart":"85/85735405efcee379f","type":"movie","ids":{"simkl":54130,"slug":"pulp-fiction","imdb":"tt0110912","tmdb":"680","tvdb":"228","tvdbslug":"pulp-fiction","traktslug":"pulp-fiction-1994","letterboxd":"pulp-fiction"}},{"title":"GoodFellas","year":1990,"poster":"15/158523330edcd73239","fanart":"93/93666740057572894","type":"movie","ids":{"simkl":54244,"slug":"goodfellas","imdb":"tt0099685","tmdb":"769","tvdb":"380","tvdbslug":"goodfellas","traktslug":"goodfellas-1990","letterboxd":"goodfellas"}},{"title":"Schindler's List","year":1993,"poster":"90/9099504968367c144","fanart":"13/13029361c9597c91f3","type":"movie","ids":{"simkl":53706,"slug":"schindlers-list","imdb":"tt0108052","tmdb":"424","tvdb":"223","tvdbslug":"schindlers-list","traktslug":"schindler-s-list-1993","letterboxd":"schindlers-list"}},{"title":"The Lord of the Rings: The Return of the King","year":2003,"poster":"63/6395980d37b3d516b","fanart":"17/17787057f2d199222d","type":"movie","ids":{"simkl":53230,"slug":"the-lord-of-the-rings-the-return-of-the-king","imdb":"tt0167260","tmdb":"122","tvdb":"74","tvdbslug":"the-lord-of-the-rings-the-return-of-the-king","traktslug":"the-lord-of-the-rings-the-return-of-the-king-2003","letterboxd":"the-lord-of-the-rings-the-return-of-the-king"}},{"title":"The Godfather Part III","year":1990,"poster":"10/107092286cab0db220","fanart":"12/123967433eab69ea71","type":"movie","ids":{"simkl":53440,"slug":"the-godfather-part-iii","imdb":"tt0099674","tmdb":"242","tvdb":"2270","tvdbslug":"the-godfather-part-iii","traktslug":"the-godfather-part-iii-1990","letterboxd":"the-godfather-part-iii"}},{"title":"Se7en","year":1995,"poster":"14/144965375ca9fc76fe","fanart":"17/17793503d9b0fb7df0","type":"movie","ids":{"simkl":54320,"slug":"se7en","imdb":"tt0114369","tmdb":"807","tvdb":"268","tvdbslug":"se7en","traktslug":"se7en-1995","letterboxd":"se7en"}},{"title":"Scarface","year":1983,"poster":"86/8629636763bed5497","fanart":"98/989114247c6648903","type":"movie","ids":{"simkl":53210,"slug":"scarface","imdb":"tt0086250","tmdb":"111","tvdb":"814","tvdbslug":"scarface","traktslug":"scarface-1983","letterboxd":"scarface-1983"}},{"title":"Saving Private Ryan","year":1998,"poster":"10/103676187457099e54","fanart":"15/15814239e0f35474c4","type":"movie","ids":{"simkl":54412,"slug":"saving-private-ryan","imdb":"tt0120815","tmdb":"857","tvdb":"569","tvdbslug":"saving-private-ryan","traktslug":"saving-private-ryan-1998","letterboxd":"saving-private-ryan"}},{"title":"The Departed","year":2006,"poster":"13/13674473e46f95cdd4","fanart":"13/13674477bfedaad250","type":"movie","ids":{"simkl":54902,"slug":"the-departed","imdb":"tt0407887","tmdb":"1422","tvdb":"590","tvdbslug":"the-departed","traktslug":"the-departed-2006","letterboxd":"the-departed"}},{"title":"The Green Mile","year":1999,"poster":"76/76391421d79530e5a","fanart":"11/11322424095ca0b054","type":"movie","ids":{"simkl":53812,"slug":"the-green-mile","imdb":"tt0120689","tmdb":"497","tvdb":"308","tvdbslug":"the-green-mile","traktslug":"the-green-mile-1999","letterboxd":"the-green-mile"}},{"title":"The Prestige","year":2006,"poster":"67/6722296cb6c55c210","fanart":"94/9414712860d8f4c31","type":"movie","ids":{"simkl":54704,"slug":"the-prestige","imdb":"tt0482571","tmdb":"1124","tvdb":"302","tvdbslug":"the-prestige","traktslug":"the-prestige-2006","letterboxd":"the-prestige"}}],"similar":[{"title":"The Irishman","year":2019,"poster":"87/8790948137bec1de3","fanart":"87/87909629ae08357a2","type":"movie","ids":{"simkl":587336,"slug":"the-irishman","imdb":"tt1302006","tmdb":"398978","tvdb":"14156","tvdbslug":"the-irishman","traktslug":"the-irishman-2019","letterboxd":"the-irishman-2019"}},{"title":"American Gangster","year":2007,"poster":"10/10515064950eb9fa77","fanart":"10/104755149d1329e2f0","type":"movie","ids":{"simkl":58740,"slug":"american-gangster","imdb":"tt0765429","tmdb":"4982","tvdb":"839","tvdbslug":"american-gangster","traktslug":"american-gangster-2007","letterboxd":"american-gangster"}},{"title":"The Informer","year":2019,"poster":"77/7738870688eeddc47","fanart":"89/891157626327d7d2b","type":"movie","ids":{"simkl":701722,"slug":"the-informer","imdb":"tt1833116","tmdb":"466081","tvdb":"16779","tvdbslug":"the-informer-2019","traktslug":"the-informer-2019","letterboxd":"the-informer-2019"}},{"title":"The Alto Knights","year":2025,"poster":"17/174106092647c3da62","fanart":"17/17480367c86955e951","type":"movie","ids":{"simkl":1976779,"slug":"the-alto-knights","imdb":"tt21815562","tmdb":"1013601","tvdb":"355407","tvdbslug":"alto-knights","traktslug":"the-alto-knights-2025","letterboxd":"alto-knights"}},{"title":"Shot Caller","year":2017,"poster":"57/575092496f4b4cca6","fanart":"57/5750932f1ccb83751","type":"movie","ids":{"simkl":494612,"slug":"shot-caller","imdb":"tt4633690","tmdb":"339692","tvdb":"577","tvdbslug":"shot-caller","traktslug":"shot-caller-2017","letterboxd":"shot-caller"}},{"title":"Four Brothers","year":2005,"poster":"10/1004334633058fd160","fanart":"10/10152138d2a87b575b","type":"movie","ids":{"simkl":61096,"slug":"four-brothers","imdb":"tt0430105","tmdb":"8292","tvdb":"6684","tvdbslug":"four-brothers","traktslug":"four-brothers-2005","letterboxd":"four-brothers"}},{"title":"Cold in July","year":2014,"poster":"20/20572037eab2b625b3","fanart":"55/55014864352d9c52c","type":"movie","ids":{"simkl":341502,"slug":"cold-in-july","imdb":"tt1179031","tmdb":"244509","tvdb":"5847","tvdbslug":"cold-in-july","traktslug":"cold-in-july-2014","letterboxd":"cold-in-july"}},{"title":"A Haunting in Venice","year":2023,"poster":"14/14719327ed39416ba4","fanart":"14/14719351926e33d113","type":"movie","ids":{"simkl":1879933,"slug":"a-haunting-in-venice","imdb":"tt22687790","tmdb":"945729","tvdb":"340798","tvdbslug":"a-haunting-in-venice","traktslug":"a-haunting-in-venice-2023","letterboxd":"a-haunting-in-venice"}},{"title":"A Walk Among the Tombstones","year":2014,"poster":"97/9758276a55983f3fd","fanart":"15/155391111df710f7c4","type":"movie","ids":{"simkl":262960,"slug":"a-walk-among-the-tombstones","imdb":"tt0365907","tmdb":"169917","tvdb":"487","tvdbslug":"a-walk-among-the-tombstones","traktslug":"a-walk-among-the-tombstones-2014","letterboxd":"a-walk-among-the-tombstones"}}]}},"unknown_id_empty":{"title":"unknown_id_empty","summary":"Unknown Simkl ID — empty array (Type 3 null)","description":"When the path Simkl ID is well-formed (numeric) but no catalog record exists at that ID, the response is `200 []`, not `404`. Treat as 'not found' — see [Null and missing values · Type 3](/conventions/null-values#type-3). Empty results are also cached.","value":[]}},"exampleType":"examples"}},"exampleType":"examples"},"88d0202a-51a0-4f63-8cf0-b606ce32fb21":{"description":"The requested item ID or URL does not exist.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for 4xx and 5xx responses. Branch on `error` (machine-readable identifier) — `message`, when present, is human-readable guidance and is **not stable across releases**.","properties":{"error":{"type":"string","description":"Machine-readable error identifier. Stable across responses — use this for programmatic branching in client code. Examples: `user_token_failed`, `client_id_failed`, `empty_field`, `wrong_parameter`, `id_err`, `rate_limit`.","example":"user_token_failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"integer","description":"HTTP status code echoed in the body for convenience — same value as the response status line. Always an integer.","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable error guidance. Optional — present on most errors, but not guaranteed. May reference the specific field or value that triggered the error. NOT stable; do not parse.","example":"Your client_id is wrong. Try another one","uniqueKey":"message","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"id_err","code":404},"examples":{"Example":{"title":"Example","value":{"error":"id_err","code":404}}},"exampleType":"examples"}},"exampleType":"examples"},"b6537332-bdf0-4ee5-a9b9-4ce8fa7ddbe9":{"description":"Your `client_id` is missing, wrong, disabled, or has hit a request limit. Verify in your [developer settings](https://simkl.com/settings/developer/).","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for 4xx and 5xx responses. Branch on `error` (machine-readable identifier) — `message`, when present, is human-readable guidance and is **not stable across releases**.","properties":{"error":{"type":"string","description":"Machine-readable error identifier. Stable across responses — use this for programmatic branching in client code. Examples: `user_token_failed`, `client_id_failed`, `empty_field`, `wrong_parameter`, `id_err`, `rate_limit`.","example":"user_token_failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"integer","description":"HTTP status code echoed in the body for convenience — same value as the response status line. Always an integer.","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable error guidance. Optional — present on most errors, but not guaranteed. May reference the specific field or value that triggered the error. NOT stable; do not parse.","example":"Your client_id is wrong. Try another one","uniqueKey":"message","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"client_id_failed","code":412,"message":"Your client_id is wrong. Try another one"},"examples":{"Example":{"title":"Example","value":{"error":"client_id_failed","code":412,"message":"Your client_id is wrong. Try another one"}}},"exampleType":"examples"}},"exampleType":"examples"},"33de15e2-f039-45c6-97a5-8df116b79900":{"description":"Too many requests in too short a window. Back off and retry with exponential backoff — see [Rate limits](/resources/rate-limits) for the playbook.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for 4xx and 5xx responses. Branch on `error` (machine-readable identifier) — `message`, when present, is human-readable guidance and is **not stable across releases**.","properties":{"error":{"type":"string","description":"Machine-readable error identifier. Stable across responses — use this for programmatic branching in client code. Examples: `user_token_failed`, `client_id_failed`, `empty_field`, `wrong_parameter`, `id_err`, `rate_limit`.","example":"user_token_failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"integer","description":"HTTP status code echoed in the body for convenience — same value as the response status line. Always an integer.","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable error guidance. Optional — present on most errors, but not guaranteed. May reference the specific field or value that triggered the error. NOT stable; do not parse.","example":"Your client_id is wrong. Try another one","uniqueKey":"message","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"rate_limit","code":429},"examples":{"Example":{"title":"Example","value":{"error":"rate_limit","code":429}}},"exampleType":"examples"}},"exampleType":"examples"},"ca77c3a2-024b-4288-8b5a-008da2c14044":{"description":"Something is broken on Simkl's side. Retry after a short delay. If it persists, report on the [Simkl Discord](https://discord.gg/MJsWNE4).","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for 4xx and 5xx responses. Branch on `error` (machine-readable identifier) — `message`, when present, is human-readable guidance and is **not stable across releases**.","properties":{"error":{"type":"string","description":"Machine-readable error identifier. Stable across responses — use this for programmatic branching in client code. Examples: `user_token_failed`, `client_id_failed`, `empty_field`, `wrong_parameter`, `id_err`, `rate_limit`.","example":"user_token_failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"integer","description":"HTTP status code echoed in the body for convenience — same value as the response status line. Always an integer.","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable error guidance. Optional — present on most errors, but not guaranteed. May reference the specific field or value that triggered the error. NOT stable; do not parse.","example":"Your client_id is wrong. Try another one","uniqueKey":"message","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"internal","code":500},"examples":{"Example":{"title":"Example","value":{"error":"internal","code":500}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"0404796a-744a-47b8-ae7e-5c77caec72f8":{"simklApiKey":{"type":"apiKey","in":"header","name":"simkl-api-key","description":"Optional alias for the `client_id` query parameter. Simkl accepts your `client_id` either as the `simkl-api-key` request header **or** as the `?client_id=…` query parameter — pick one. The query-parameter form is preferred because it makes the request fully self-describing in URL form.","x-default":"YOUR_CLIENT_ID","scopes":[],"schemeName":"simklApiKey"}}},"servers":{"1ff7513b-7c65-431d-a68f-d379fa335309":{"url":"https://api.simkl.com","description":"Production API"},"23b65516-5008-4875-b78d-4bd0b879e4f4":{"url":"https://data.simkl.in","description":"CDN for static, public data files (Calendar + Trending). No auth required."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"simkl-api-key","description":"Optional alias for the `client_id` query parameter. Simkl accepts your `client_id` either as the `simkl-api-key` request header **or** as the `?client_id=…` query parameter — pick one. The query-parameter form is preferred because it makes the request fully self-describing in URL form.","x-default":"YOUR_CLIENT_ID","scopes":[],"schemeName":"simklApiKey"},"schema":{"title":"simkl-api-key","type":"string","description":"Optional alias for the `client_id` query parameter. Simkl accepts your `client_id` either as the `simkl-api-key` request header **or** as the `?client_id=…` query parameter — pick one. The query-parameter form is preferred because it makes the request fully self-describing in URL form.","isRequired":true,"default":"YOUR_CLIENT_ID","typeLabel":"string","deprecated":false},"schemeName":"simklApiKey","name":"simkl-api-key"}],"title":"simklApiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"andrewmasyk","siteName":"Simkl API","title":"Movie details - Simkl API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T20:32:47.973Z","originalFileLocation":"api-reference/simkl/get-movie.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Full detail record for one movie — title, overview, year, runtime, country, language, certification, genres, director, ratings, posters, fanart, external IDs, alternate titles, release-date list per region, budget, revenue, trailers, similar-movie recommendations. The default response is already complete; no flags needed. Responses are Cloudflare-cached by Simkl ID, so repeat lookups of popular titles are near-free. Parallel requests against this endpoint are explicitly allowed (see Rate limits → Parallel requests). Cache invalidation is automatic. When Simkl updates the underlying record (admin edits, automated metadata refresh, image swap, related-titles change, etc.), the corresponding Cloudflare cache entry is purged server-side. The next call to this endpoint returns the fresh data — there\u0026#x27;s no TTL to wait out and no client-side cache-busting needed. Your own app-level cache, if any, still has to be invalidated by your client. Use a Simkl ID for the lookup. If you only have an external ID, resolve it via GET /redirect first. Which IDs can I send/expect? All accepted input identifiers and the keys you\u0026#x27;ll see echoed back in responses are listed at Standard media objects → Supported ID keys. Send every ID you have on writes — Simkl picks the first that resolves and ignores the rest. Reminder: slug is response-only (never send it on a request).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Simkl API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Movie details - Simkl API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Full detail record for one movie — title, overview, year, runtime, country, language, certification, genres, director, ratings, posters, fanart, external IDs, alternate titles, release-date list per region, budget, revenue, trailers, similar-movie recommendations. The default response is already complete; no flags needed. Responses are Cloudflare-cached by Simkl ID, so repeat lookups of popular titles are near-free. Parallel requests against this endpoint are explicitly allowed (see Rate limits → Parallel requests). Cache invalidation is automatic. When Simkl updates the underlying record (admin edits, automated metadata refresh, image swap, related-titles change, etc.), the corresponding Cloudflare cache entry is purged server-side. The next call to this endpoint returns the fresh data — there\u0026#x27;s no TTL to wait out and no client-side cache-busting needed. Your own app-level cache, if any, still has to be invalidated by your client. Use a Simkl ID for the lookup. If you only have an external ID, resolve it via GET /redirect first. Which IDs can I send/expect? All accepted input identifiers and the keys you\u0026#x27;ll see echoed back in responses are listed at Standard media objects → Supported ID keys. Send every ID you have on writes — Simkl picks the first that resolves and ignores the rest. Reminder: slug is response-only (never send it on a request).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Simkl API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api.simkl.org/api-reference/simkl/get-movie\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://i.simkl.com/img_tv/apiary_logo_api.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Movie details - Simkl API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Full detail record for one movie — title, overview, year, runtime, country, language, certification, genres, director, ratings, posters, fanart, external IDs, alternate titles, release-date list per region, budget, revenue, trailers, similar-movie recommendations. The default response is already complete; no flags needed. Responses are Cloudflare-cached by Simkl ID, so repeat lookups of popular titles are near-free. Parallel requests against this endpoint are explicitly allowed (see Rate limits → Parallel requests). Cache invalidation is automatic. When Simkl updates the underlying record (admin edits, automated metadata refresh, image swap, related-titles change, etc.), the corresponding Cloudflare cache entry is purged server-side. The next call to this endpoint returns the fresh data — there\u0026#x27;s no TTL to wait out and no client-side cache-busting needed. Your own app-level cache, if any, still has to be invalidated by your client. Use a Simkl ID for the lookup. If you only have an external ID, resolve it via GET /redirect first. Which IDs can I send/expect? All accepted input identifiers and the keys you\u0026#x27;ll see echoed back in responses are listed at Standard media objects → Supported ID keys. Send every ID you have on writes — Simkl picks the first that resolves and ignores the rest. Reminder: slug is response-only (never send it on a request).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://i.simkl.com/img_tv/apiary_logo_api.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Simkl API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api.simkl.org/api-reference/simkl/get-movie\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/simkl/get-movie.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api.simkl.org/#organization\",\"name\":\"Simkl API\",\"url\":\"https://api.simkl.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/andrewmasyk/yVND0Vg0vHbm_kqK/logo/light.svg?fit=max\u0026auto=format\u0026n=yVND0Vg0vHbm_kqK\u0026q=85\u0026s=3ed4c7fdfb9f19455db11c9a13dd466e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api.simkl.org#website\",\"name\":\"Simkl API\",\"url\":\"https://api.simkl.org\",\"publisher\":{\"@id\":\"https://api.simkl.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api.simkl.org/api-reference/simkl/get-movie#webpage\",\"url\":\"https://api.simkl.org/api-reference/simkl/get-movie\",\"name\":\"Movie details\",\"description\":\"Full detail record for one movie — title, overview, year, runtime, country, language, certification, genres, director, ratings, posters, fanart, external IDs, alternate titles, release-date list per region, budget, revenue, trailers, similar-movie recommendations. The default response is already complete; no flags needed. Responses are Cloudflare-cached by Simkl ID, so repeat lookups of popular titles are near-free. Parallel requests against this endpoint are explicitly allowed (see Rate limits → Parallel requests). Cache invalidation is automatic. When Simkl updates the underlying record (admin edits, automated metadata refresh, image swap, related-titles change, etc.), the corresponding Cloudflare cache entry is purged server-side. The next call to this endpoint returns the fresh data — there's no TTL to wait out and no client-side cache-busting needed. Your own app-level cache, if any, still has to be invalidated by your client. Use a Simkl ID for the lookup. If you only have an external ID, resolve it via GET /redirect first. Which IDs can I send/expect? All accepted input identifiers and the keys you'll see echoed back in responses are listed at Standard media objects → Supported ID keys. Send every ID you have on writes — Simkl picks the first that resolves and ignores the rest. Reminder: slug is response-only (never send it on a request).\",\"dateModified\":\"2026-11-15T20:32:47.973Z\",\"isPartOf\":{\"@id\":\"https://api.simkl.org#website\"},\"breadcrumb\":{\"@id\":\"https://api.simkl.org/api-reference/simkl/get-movie#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api.simkl.org/api-reference/simkl/get-movie#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Movies\",\"item\":\"https://api.simkl.org/api-reference/movies\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Movie details\",\"item\":\"https://api.simkl.org/api-reference/simkl/get-movie\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api.simkl.org/api-reference/simkl/get-movie#apireference\",\"headline\":\"Movie details\",\"name\":\"Movie details\",\"description\":\"Full detail record for one movie — title, overview, year, runtime, country, language, certification, genres, director, ratings, posters, fanart, external IDs, alternate titles, release-date list per region, budget, revenue, trailers, similar-movie recommendations. The default response is already complete; no flags needed. Responses are Cloudflare-cached by Simkl ID, so repeat lookups of popular titles are near-free. Parallel requests against this endpoint are explicitly allowed (see Rate limits → Parallel requests). Cache invalidation is automatic. When Simkl updates the underlying record (admin edits, automated metadata refresh, image swap, related-titles change, etc.), the corresponding Cloudflare cache entry is purged server-side. The next call to this endpoint returns the fresh data — there's no TTL to wait out and no client-side cache-busting needed. Your own app-level cache, if any, still has to be invalidated by your client. Use a Simkl ID for the lookup. If you only have an external ID, resolve it via GET /redirect first. Which IDs can I send/expect? All accepted input identifiers and the keys you'll see echoed back in responses are listed at Standard media objects → Supported ID keys. Send every ID you have on writes — Simkl picks the first that resolves and ignores the rest. Reminder: slug is response-only (never send it on a request).\",\"url\":\"https://api.simkl.org/api-reference/simkl/get-movie\",\"mainEntityOfPage\":{\"@id\":\"https://api.simkl.org/api-reference/simkl/get-movie#webpage\"},\"image\":\"https://i.simkl.com/img_tv/apiary_logo_api.png\",\"dateModified\":\"2026-11-15T20:32:47.973Z\",\"publisher\":{\"@id\":\"https://api.simkl.org/#organization\"},\"isPartOf\":{\"@id\":\"https://api.simkl.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Simkl API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Simkl API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/simkl/get-movie.md","siteName":"Simkl API","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Documentation","icon":"book-open","align":"start","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"code","align":"start","groups":[{"group":"API Reference","icon":"book-bookmark","pages":[{"title":"Introduction","sidebarTitle":"Introduction","icon":"circle-info","href":"/api-reference/introduction"},{"title":"Pagination","icon":"list-ol","href":"/conventions/pagination"},{"title":"Rate limits","icon":"gauge","href":"/resources/rate-limits"},{"title":"Errors and status codes","sidebarTitle":"Errors","icon":"triangle-exclamation","href":"/conventions/errors"}]},{"group":"Trending","icon":"fire","pages":[{"title":"Trending data files","sidebarTitle":"Trending","icon":"fire","href":"/api-reference/trending"}]},{"group":"Calendar","icon":"calendar","pages":[{"title":"Calendar data files","sidebarTitle":"Calendar","icon":"calendar","href":"/api-reference/calendar"}]},{"group":"Redirect","icon":"arrow-right","pages":[{"title":"Redirect \u0026 deep-linking","sidebarTitle":"About Redirect","icon":"circle-info","href":"/api-reference/redirect"},{"title":"Resolve any ID and redirect to Simkl","deprecated":null,"version":null,"sidebarTitle":"Redirect","openapi":"/openapi.json get /redirect","href":"/api-reference/simkl/redirect"}]},{"group":"Auth","icon":"shield-halved","pages":[{"title":"Set up authentication","sidebarTitle":"Set up auth","icon":"wrench","href":"/api-reference/auth"},{"group":"AUTH V2","icon":"shield-check","pages":[{"title":"AUTH V2 overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/auth-v2"},{"group":"OAuth","icon":"lock","pages":[{"title":"OAuth 2.0 flow (AUTH V2)","sidebarTitle":"Walkthrough","icon":"browser","href":"/api-reference/oauth2-authorization-code"},{"title":"PKCE in AUTH V2","sidebarTitle":"PKCE","icon":"shield-keyhole","href":"/api-reference/oauth2-pkce"},{"title":"Authorize (V2)","deprecated":null,"version":null,"sidebarTitle":"Authorize","playground":"simple","openapi":"/openapi.json get /oauth2/authorize","href":"/api-reference/simkl/oauth2-authorize"},{"title":"Token (V2)","deprecated":null,"version":null,"sidebarTitle":"Token (code, refresh, device)","openapi":"/openapi.json post /oauth2/token","href":"/api-reference/simkl/oauth2-token"}]},{"group":"Device / PIN","icon":"tv","pages":[{"title":"Device / PIN flow (AUTH V2)","sidebarTitle":"Walkthrough","icon":"qrcode","href":"/api-reference/oauth2-device"},{"title":"Device authorization (V2)","deprecated":null,"version":null,"sidebarTitle":"Request device code","openapi":"/openapi.json post /oauth2/device","href":"/api-reference/simkl/oauth2-device"}]},{"group":"Tokens \u0026 scopes","icon":"rotate","pages":[{"title":"Tokens and refresh (AUTH V2)","sidebarTitle":"Refreshing","icon":"key","href":"/api-reference/oauth2-tokens"},{"title":"Scopes (AUTH V2)","sidebarTitle":"Scopes","icon":"list-check","href":"/api-reference/oauth2-scopes"},{"title":"Revoke token (V2)","deprecated":null,"version":null,"sidebarTitle":"Revoke token","openapi":"/openapi.json post /oauth2/revoke","href":"/api-reference/simkl/oauth2-revoke"}]},{"title":"OAuth client libraries (AUTH V2)","sidebarTitle":"Client libraries","icon":"puzzle-piece","href":"/api-reference/oauth2-libraries"}]},{"group":"AUTH V1","icon":"clock-rotate-left","pages":[{"title":"AUTH V1 overview","sidebarTitle":"Overview","icon":"clock-rotate-left","href":"/api-reference/auth-v1"},{"title":"Public PKCE (AUTH V1)","sidebarTitle":"Public PKCE","icon":"shield-keyhole","href":"/api-reference/oauth-pkce"},{"group":"OAuth","icon":"lock","pages":[{"title":"OAuth flow (AUTH V1)","sidebarTitle":"OAuth flow","icon":"route","href":"/api-reference/oauth"},{"title":"Authorize a user","deprecated":null,"version":null,"sidebarTitle":"OAuth authorize","playground":"simple","openapi":"/openapi.json get /oauth/authorize","href":"/api-reference/simkl/authorize"},{"title":"Exchange an authorization code for an access token","deprecated":null,"version":null,"sidebarTitle":"OAuth token","openapi":"/openapi.json post /oauth/token","href":"/api-reference/simkl/exchange-token"}]},{"group":"Device / PIN","icon":"tv","pages":[{"title":"PIN flow (AUTH V1)","sidebarTitle":"PIN flow","icon":"route","href":"/api-reference/pin"},{"title":"Request a PIN code","deprecated":null,"version":null,"sidebarTitle":"Request PIN","openapi":"/openapi.json get /oauth/pin","href":"/api-reference/simkl/get-pin"},{"title":"Poll PIN code for the access token","deprecated":null,"version":null,"sidebarTitle":"Poll PIN","openapi":"/openapi.json get /oauth/pin/{user_code}","href":"/api-reference/simkl/check-pin"}]},{"title":"OAuth client libraries","sidebarTitle":"Client libraries","icon":"puzzle-piece","href":"/api-reference/oauth-libraries"}]}]},{"group":"Scrobble","icon":"play","pages":[{"title":"How scrobbling works","icon":"diagram-project","href":"/api-reference/scrobble"},{"title":"Check-in","deprecated":null,"version":null,"sidebarTitle":"Check-in","openapi":"/openapi.json post /scrobble/checkin","href":"/api-reference/simkl/scrobble-checkin"},{"title":"Pause","deprecated":null,"version":null,"sidebarTitle":"Pause","openapi":"/openapi.json post /scrobble/pause","href":"/api-reference/simkl/scrobble-pause"},{"title":"Start","deprecated":null,"version":null,"sidebarTitle":"Start","openapi":"/openapi.json post /scrobble/start","href":"/api-reference/simkl/scrobble-start"},{"title":"Stop","deprecated":null,"version":null,"sidebarTitle":"Stop","openapi":"/openapi.json post /scrobble/stop","href":"/api-reference/simkl/scrobble-stop"}]},{"group":"Playback","icon":"play-pause","pages":[{"title":"How playbacks work","icon":"play-pause","href":"/api-reference/playback"},{"title":"Get paused playback sessions for every type","deprecated":null,"version":null,"sidebarTitle":"Playback (all types)","openapi":"/openapi.json get /sync/playback","href":"/api-reference/simkl/get-playback-sessions-all"},{"title":"Get paused playback sessions for one type","deprecated":null,"version":null,"sidebarTitle":"Playback (by type)","openapi":"/openapi.json get /sync/playback/{type}","href":"/api-reference/simkl/get-playback-sessions"},{"title":"Delete Playback","deprecated":null,"version":null,"sidebarTitle":"Delete Playback","openapi":"/openapi.json delete /sync/playback/{id}","href":"/api-reference/simkl/delete-playback"}]},{"group":"Sync","icon":"arrows-rotate","pages":[{"title":"Sync","sidebarTitle":"Sync","icon":"diagram-project","href":"/api-reference/sync"},{"title":"Get Last Activities","deprecated":null,"version":null,"sidebarTitle":"Last Activities","openapi":"/openapi.json get /sync/activities","href":"/api-reference/simkl/get-activities"},{"title":"Add to Watchlist","deprecated":null,"version":null,"sidebarTitle":"Add to Watchlist","openapi":"/openapi.json post /sync/add-to-list","href":"/api-reference/simkl/add-to-list"},{"title":"Get all items of one type in one status bucket","deprecated":null,"version":null,"sidebarTitle":"All items","openapi":"/openapi.json get /sync/all-items/{type}/{status}","href":"/api-reference/simkl/get-all-items"},{"title":"Add to History","deprecated":null,"version":null,"sidebarTitle":"Add to History","openapi":"/openapi.json post /sync/history","href":"/api-reference/simkl/add-to-history"},{"title":"Remove from History","deprecated":null,"version":null,"sidebarTitle":"Remove from History","openapi":"/openapi.json post /sync/history/remove","href":"/api-reference/simkl/remove-from-history"},{"title":"Add Ratings","deprecated":null,"version":null,"sidebarTitle":"Add Ratings","openapi":"/openapi.json post /sync/ratings","href":"/api-reference/simkl/add-ratings"},{"title":"Remove Ratings","deprecated":null,"version":null,"sidebarTitle":"Remove Ratings","openapi":"/openapi.json post /sync/ratings/remove","href":"/api-reference/simkl/remove-ratings"},{"title":"Get the user's rated items, filtered by type and rating","deprecated":null,"version":null,"sidebarTitle":"User ratings","openapi":"/openapi.json get /sync/ratings/{type}/{rating}","href":"/api-reference/simkl/get-user-ratings"},{"title":"Look up watched status for items","deprecated":null,"version":null,"sidebarTitle":"Lookup watched","openapi":"/openapi.json post /sync/watched","href":"/api-reference/simkl/get-watched"}]},{"group":"Custom Lists","icon":"list","pages":[{"title":"Custom lists","sidebarTitle":"Overview","icon":"list","href":"/api-reference/lists"},{"title":"Get a custom list","deprecated":null,"version":null,"sidebarTitle":"Get custom list","openapi":"/openapi.json get /lists/{id}","href":"/api-reference/simkl/get-list"},{"title":"Get a user's custom lists","deprecated":null,"version":null,"sidebarTitle":"Get user's custom lists","openapi":"/openapi.json get /lists/user/{userId}","href":"/api-reference/simkl/get-user-lists"},{"title":"Create a custom list","deprecated":null,"version":null,"sidebarTitle":"Create custom list","openapi":"/openapi.json post /lists","href":"/api-reference/simkl/create-list"},{"title":"Edit a custom list","deprecated":null,"version":null,"sidebarTitle":"Edit custom list","openapi":"/openapi.json post /lists/{id}","href":"/api-reference/simkl/update-list"},{"title":"Delete a custom list","deprecated":null,"version":null,"sidebarTitle":"Delete custom list","openapi":"/openapi.json delete /lists/{id}","href":"/api-reference/simkl/delete-list"},{"title":"Add or reorder titles in a custom list","deprecated":null,"version":null,"sidebarTitle":"Add list items","openapi":"/openapi.json post /lists/{id}/items","href":"/api-reference/simkl/add-list-items"},{"title":"Remove titles from a custom list","deprecated":null,"version":null,"sidebarTitle":"Remove list items","openapi":"/openapi.json post /lists/{id}/items/remove","href":"/api-reference/simkl/remove-list-items"},{"title":"Add favorites","deprecated":null,"version":null,"sidebarTitle":"Add favorites","openapi":"/openapi.json post /lists/favorites","href":"/api-reference/simkl/add-favorites"},{"title":"Remove favorites","deprecated":null,"version":null,"sidebarTitle":"Remove favorites","openapi":"/openapi.json post /lists/favorites/remove","href":"/api-reference/simkl/remove-favorites"}]},{"group":"Search","icon":"magnifying-glass","pages":[{"title":"About Search","icon":"circle-info","href":"/api-reference/search"},{"title":"Find an item by file name","deprecated":null,"version":null,"sidebarTitle":"By file","openapi":"/openapi.json post /search/file","href":"/api-reference/simkl/search-by-file"},{"title":"Find items by external ID","deprecated":null,"version":null,"sidebarTitle":"By ID","openapi":"/openapi.json get /search/id","href":"/api-reference/simkl/search-by-id"},{"title":"Random pick","deprecated":null,"version":null,"sidebarTitle":"Random","openapi":"/openapi.json post /search/random","href":"/api-reference/simkl/search-random"},{"title":"Search by text query","deprecated":null,"version":null,"sidebarTitle":"By text","openapi":"/openapi.json get /search/{type}","href":"/api-reference/simkl/search-by-text"}]},{"group":"TV","icon":"tv","pages":[{"title":"About TV","icon":"circle-info","href":"/api-reference/tv"},{"group":"Look up a show","icon":"magnifying-glass","pages":[{"title":"TV show details","deprecated":null,"version":null,"sidebarTitle":"TV details","openapi":"/openapi.json get /tv/{id}","href":"/api-reference/simkl/get-tv-show"},{"title":"List episodes for a TV show","deprecated":null,"version":null,"sidebarTitle":"TV episodes","openapi":"/openapi.json get /tv/episodes/{id}","href":"/api-reference/simkl/get-tv-episodes"}]},{"group":"Browse \u0026 discover","icon":"compass","pages":[{"title":"TV shows airing today, tomorrow, or on a specific date","deprecated":null,"version":null,"sidebarTitle":"Airing TV","openapi":"/openapi.json get /tv/airing","href":"/api-reference/simkl/get-tv-airing"},{"title":"TV premieres (new + upcoming)","deprecated":null,"version":null,"sidebarTitle":"Premieres","openapi":"/openapi.json get /tv/premieres/{param}","href":"/api-reference/simkl/get-tv-premieres"},{"title":"Top-rated TV shows","deprecated":null,"version":null,"sidebarTitle":"Best of","openapi":"/openapi.json get /tv/best/{filter}","href":"/api-reference/simkl/get-best-tv"},{"title":"TV by genre","deprecated":null,"version":null,"sidebarTitle":"Genres","openapi":"/openapi.json get /tv/genres/{genre}/{type}/{country}/{network}/{year}/{sort}","href":"/api-reference/simkl/get-tv-genres"}]},{"title":"Trending data files","sidebarTitle":"Trending","icon":"fire","href":"/api-reference/trending"},{"title":"Calendar data files","sidebarTitle":"Calendar","icon":"calendar","href":"/api-reference/calendar"}]},{"group":"Anime","icon":"dragon","pages":[{"title":"About Anime","icon":"circle-info","href":"/api-reference/anime"},{"group":"Look up an anime","icon":"magnifying-glass","pages":[{"title":"Anime details","deprecated":null,"version":null,"sidebarTitle":"Anime details","openapi":"/openapi.json get /anime/{id}","href":"/api-reference/simkl/get-anime"},{"title":"List episodes for an anime","deprecated":null,"version":null,"sidebarTitle":"Anime episodes","openapi":"/openapi.json get /anime/episodes/{id}","href":"/api-reference/simkl/get-anime-episodes"}]},{"group":"Browse \u0026 discover","icon":"compass","pages":[{"title":"Anime airing today, tomorrow, or on a specific date","deprecated":null,"version":null,"sidebarTitle":"Airing anime","openapi":"/openapi.json get /anime/airing","href":"/api-reference/simkl/get-anime-airing"},{"title":"Anime premieres (new + upcoming)","deprecated":null,"version":null,"sidebarTitle":"Premieres","openapi":"/openapi.json get /anime/premieres/{param}","href":"/api-reference/simkl/get-anime-premieres"},{"title":"Top-rated anime","deprecated":null,"version":null,"sidebarTitle":"Best of","openapi":"/openapi.json get /anime/best/{filter}","href":"/api-reference/simkl/get-best-anime"},{"title":"Anime by genre","deprecated":null,"version":null,"sidebarTitle":"Genres","openapi":"/openapi.json get /anime/genres/{genre}/{type}/{network}/{year}/{sort}","href":"/api-reference/simkl/get-anime-genres"}]},{"title":"Trending data files","sidebarTitle":"Trending","icon":"fire","href":"/api-reference/trending"},{"title":"Calendar data files","sidebarTitle":"Calendar","icon":"calendar","href":"/api-reference/calendar"}]},{"group":"Movies","icon":"film","pages":[{"title":"About Movies","description":"Browse and look up movies — discover by genre/country/year, or pull full details for a single title.","icon":"circle-info","href":"/api-reference/movies"},{"title":"Movie details","deprecated":null,"version":null,"sidebarTitle":"Movie details","openapi":"/openapi.json get /movies/{id}","href":"/api-reference/simkl/get-movie"},{"title":"Movies by genre","description":"\u003cWarning>\n**Not for TV / console / 10-foot apps.** The V1 genre-browse endpoints return a thin per-item shape (`title`, `year`, `poster`, `ids`, `ratings`, `rank`). Building a TV-app grid that shows overview text, full ratings, networks, runtimes, recommendations, or trailers would force one per-item refetch against the detail endpoint per visible card. **Wait for the V2 Beta API**, which returns the richer per-item shape TV-app surfaces need in a single call. If you're targeting TV / console / streaming-box clients, please hold off integrating these endpoints.\n\u003c/Warning>\n\n\u003cTip>\n**Just need this month's most watched titles in a genre? Use the [trending genre files](/api-reference/trending#by-genre-this-month) instead.** They are free: they don't count against any [rate limit](/resources/rate-limits#what-does-not-count) or a user's daily allowance, and they need no user token. Every call to this endpoint does count — against the user's daily allowance under [AUTH V2](/api-reference/auth-v2), where it also needs a user token, or your app's allowance under AUTH V1.\n\nA genre file is one cached request with no paging, and every item comes in the full trending shape (overview, trailer, ratings, runtime) rather than the thin shape above. Call this endpoint only for what the files don't cover: other sorts, the country / network / year filters, or anything beyond this month.\n\u003c/Tip>\n\nBrowse movies filtered by genre, country, year, and sort order. Path is `/movies/genres/{genre}/{type}/{country}/{year}/{sort}` — all segments **required** (use `all` as the wildcard).\n\nThe `type` segment is reserved — always pass the literal value `movies`.\n\n| Path param | Values |\n|---|---|\n| `genre` | `all`, `action`, `adventure`, `animation`, `comedy`, `crime`, `documentary`, `drama`, `erotica`, `family`, `fantasy`, `history`, `horror`, `music`, `mystery`, `romance`, `science-fiction`, `thriller`, `tv-movie`, `war`, `western` |\n| `type` | `movies` (literal) |\n| `country` | `all` or ISO 3166-1 alpha-2 (`us`, `gb`, `jp`, …) |\n| `year` | `all`, single year (`2019`), or decade (`2010s`, `2000s`) |\n| `sort` | `popular-this-week`, `popular-this-month`, `popular-all-time`, `rank`, `release-date`, `voted`, `watched` |\n\nItems always carry `ids.tmdb` — the discover query filters out movies without a TMDB-linked record.\n\n#### Pagination\n\n| Param | Default | Notes |\n|---|---|---|\n| `page` | `1` | Hard-capped server-side at `20`. Higher values clamp silently. |\n| `limit` | `60` | Hard-capped server-side at `60`. Higher values clamp silently. Returned `X-Pagination-Limit` reflects the clamped value. |\n\n`X-Pagination-*` headers on every response — see [Pagination](/conventions/pagination).\n\n#### Silent fallbacks\n\nBad path segments DO NOT return errors:\n\n| Bad input | What happens |\n|---|---|\n| Unknown `genre` slug (`zzz`) | Top-level response is `null` (NOT `[]`). |\n| Unknown `year` (e.g. `zzz`) | Silently treated as `all` — full result set. |\n| Unknown `sort` (`zzzsortzzz`) | Silently treated as default sort order. |\n| Unknown `country` / `network` | Silently treated as `all`. |\n\n#### Errors\n\n| Status | When |\n|---|---|\n| `401 user_token_required` | AUTH V2 app called without the user's token |\n| `412 client_id_failed` | Missing or invalid `client_id` |\n| `500` | Server error |\n\nNo `400` or `404` — bad segments fall back silently or return `null`.\n","deprecated":null,"version":null,"sidebarTitle":"Genres","openapi":"/openapi.json get /movies/genres/{genre}/{type}/{country}/{year}/{sort}","href":"/api-reference/simkl/get-movies-genres"},{"title":"Trending data files","sidebarTitle":"Trending","icon":"fire","href":"/api-reference/trending"},{"title":"Calendar data files","sidebarTitle":"Calendar","icon":"calendar","href":"/api-reference/calendar"}]},{"group":"Ratings","icon":"star","pages":[{"title":"About Ratings","icon":"circle-info","href":"/api-reference/ratings"},{"title":"Community ratings for items in the user's watchlist","deprecated":null,"version":null,"sidebarTitle":"Watchlist ratings","openapi":"/openapi.json get /ratings/{type}","href":"/api-reference/simkl/get-watchlist-ratings"}]},{"group":"Users","icon":"user","pages":[{"title":"About Users","icon":"circle-info","href":"/api-reference/users"},{"title":"Redirect to a user's last-watched cover image","deprecated":null,"version":null,"sidebarTitle":"Cover image","openapi":"/openapi.json get /users/recently-watched-background/{user_id}","href":"/api-reference/simkl/get-recently-watched-image"},{"title":"Get the authenticated user's settings","deprecated":null,"version":null,"sidebarTitle":"User settings","openapi":"/openapi.json get /users/settings","href":"/api-reference/simkl/get-user-settings"},{"title":"Get a user's watch statistics","deprecated":null,"version":null,"sidebarTitle":"User stats","openapi":"/openapi.json get /users/{user_id}/stats","href":"/api-reference/simkl/get-user-stats"}]},{"group":"Changes","icon":"code-compare","pages":[{"title":"Recently changed catalog items","deprecated":null,"version":null,"sidebarTitle":"Recent changes","openapi":"/openapi.json get /changes","href":"/api-reference/simkl/get-changes"}]}]},{"tab":"Changelog","icon":"clock-rotate-left","align":"start","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Movie details - Simkl API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}