Skip to main content
Simkl returns different amounts of data depending on the endpoint. Most lookups now return the rich record by default — you only need the extended parameter on a small set of endpoints, and the accepted values vary per endpoint.

​
At a glance

​
Summary endpoints — no extended needed

Calling a summary endpoint returns the full media object out of the box:
You’ll get back overview, ratings, genres, trailers, recommendations — everything that used to require ?extended=full. The parameter is still accepted for backward compatibility, but it’s a no-op on /movies/:id, /tv/:id, /anime/:id, /tv/episodes/:id, and /anime/episodes/:id.

​
GET /sync/all-items/:type/:status — multiple modes

This is the only endpoint where extended takes one of several distinct mode values (not a comma-separated list). The default response is already rich — extended modes either reduce it to a slimmer ID-only payload (for fast deletion-reconciliation diffs) or enhance it with episode-level data and full metadata. Two query parameters interact with extended on /sync/all-items but are separate flags:
  • include_all_episodes=yes (or =original) — by default, extended=full doesn’t load seasons[].episodes[] for items in completed or dropped buckets. Set include_all_episodes=yes to load episodes on those buckets too (synthesizes virtual episode rows for items without per-episode data). Use =original to load only real per-episode rows, skipping virtual synthesis.
  • episode_watched_at=yes — adds per-episode watched_at timestamps to whatever episodes are loaded. Modifier only — episodes must already be present via extended=full or include_all_episodes=yes. Without this flag, episode entries carry only number.
See the /sync/all-items reference for the full response shape per mode, and the Sync guide for the two-phase model that puts these together. For rewatch-session reads, see the Rewatches guide.

​
Search — only /search/:type uses extended

/search/:type (free-text search) accepts only extended=full (no comma-separated values, no other modes). Default match shape (without extended): title, year, poster, endpoint_type, plus ids (simkl_id, slug, and tmdb when available). Anime entries also include title_en, title_romaji, and type (tv / movie / ova / ona / special / music video). With extended=full the response adds:
  • all_titles — alternate titles / aliases (only when more than one is known for the item)
  • url — canonical simkl.com URL
  • rank — Simkl rank for the type
  • status — running / ended / cancelled / etc.
  • ratings — Simkl + IMDb + MAL aggregate ratings (each present when available)
  • ep_count — episode count, non-movies only (TV and anime)
/search/id and /search/file don’t honour extended — they always return their default match shape. See those endpoints’ pages for the actual response fields.
For /search/id specifically, use the per-catalog ID query parameter that matches what you have (imdb, tmdb, tvdb, mal, etc.). The response shape is fixed; there’s no opt-in extension.