Feed Setup

To make integration as smooth as possible, TitanOS has introduced the Titan Schema Feed Format: a single, clearly defined structure for delivering your catalogue. Every feed can be checked automatically before it reaches us — we’re happy to share a validation script so you can self-validate on your side and catch any issues early.

Please submit your catalogue data through the Partner Portal — you’ll also find the JSON Schema files and example JSON files referenced throughout this document there.

Three documents guide your technical team through building the catalogue feed and the recommendations feed:

Feed envelope (feed.schema.json) — the envelope that wraps your catalogue: how to structure and submit it.
Content records (content.schema.json) — how to describe each individual asset: movie, series, season, episode, or sport program.
Recommendations (recommendations.schema.json) — how to structure your ranked lists per market.

Both the feed and the recommendations are full snapshots: anything absent from the document is treated as deleted (absence = delete).

Feed envelope

Defined in feed.schema.json. A single JSON object: envelope metadata followed by the content array. The envelope wraps the catalogue — metadata first, then the content itself. Every feed is a full snapshot: whatever isn’t present in contents is treated as deleted.

Field	Value & Format	Description	Required
`schema_version`	String, semver, const `"1.1.0"`	Which version of the contract this feed follows.	required
`generated_at`	`ISO 8601` / RFC 3339 UTC (e.g. `2026-07-24T14:23:00Z`)	When this snapshot was generated.	required
`mode`	`Enum`: `"full"`	Delivery mode. Only `full` is supported (absence = delete). `delta` is reserved for a future release.	required
`contents`	Array of content records (min 1)	The catalogue. Each item is a content object discriminated on `type`. An empty full feed is not allowed.	required

Content record

Defined in content.schema.json. One record per asset, discriminated on type. All types share the base fields below. Scripted/editorial types (movie, series, season, episode) also carry genre fields; sport_program does not (sports are categorised by sport / league / event_type). In the type columns: Series = tv_show. required / optional / N/A are per the schema; “req (one of)” means at least one of the synopsis fields is required.

Base fields

Scroll the table horizontally to see more.

Field Name	Value & Format	Description	Movie	Series	Season	Episode	Sport
`id`	String, stable & globally unique	Provider’s content id. Never changes. Referenced by seasons/episodes and by recommendations.	required	required	required	required	required
`type`	`Enum`: `movie`, `tv_show`, `season`, `episode`, `sport_program`	Discriminator that selects the record shape.	required	required	required	required	required
`titles`	Array of `{ locale, title }`	Localised titles, one entry per locale.	required	required	required	required	required
`original_title`	Object `{ locale?, title }`	Primary/reference title (single object, not an array). `locale` optional when the original language is unknown.	optional	optional	optional	optional	optional
`short_synopses`	Array of `{ locale, synopsis }` — synopsis ≤ 512 chars	Short synopsis per locale.	req (one of)	req (one of)	req (one of)	req (one of)	req (one of)
`medium_synopses`	Array of `{ locale, synopsis }` — synopsis ≤ 1024 chars	Medium synopsis per locale.	req (one of)	req (one of)	req (one of)	req (one of)	req (one of)
`long_synopses`	Array of `{ locale, synopsis }` — no max length	Long synopsis per locale.	req (one of)	req (one of)	req (one of)	req (one of)	req (one of)
`deeplinks`	Array of `{ platform, action, url, markets }`	Where/how to open playback. Must include at least one entry with `platform: "tv"`. See the Deeplink section.	required	required	required	required	required
`availabilities`	Array of Availability (VOD offers)	VOD offers, one per payment mechanism × market set × window. May be empty for live-only content (live offers go under `live`). See the Availabilities section.	required	required	required	required	required
`images`	Array of Image (min 1)	Artwork, screenshots, logos. Must contain at least one `artwork_landscape` or `artwork_portrait`. See the Image section.	required	required	required	required	required
`promo_videos`	Array of PromoVideo	Trailers/clips/previews. Same shape as images plus optional duration.	optional	optional	optional	optional	optional
`classifications`	Array of Classification	Age ratings per market. See the Classification section.	optional	optional	optional	optional	optional
`credits`	Array of CreditMember	Cast & crew (replaces `actors`/`directors`).	optional	optional	optional	optional	optional
`year`	`Integer`, 1888–2250	Production year. For a series, the year of the first season.	optional	optional	optional	optional	optional
`release_date`	Date `YYYY-MM-DD`	Original release date.	optional	optional	optional	optional	optional
`keywords`	Array of `{ locale, keywords[] }` — if present, min 1 locale entry; each `keywords[]` min 1 unique, non-empty string	Search/discovery keywords per locale. Use local-language terms; do not machine-translate.	optional	optional	optional	optional	optional
`identifiers`	Array of `{ platform, value }`	External IDs (replaces `external_id`).	optional	optional	optional	optional	optional
`created_at`	`ISO 8601` / RFC 3339	Creation timestamp.	optional	optional	optional	optional	optional
`updated_at`	`ISO 8601` / RFC 3339	Last-modified timestamp.	optional	optional	optional	optional	optional

Genre fields

Applies to movie, series, season and episode — not to sport.

Field Name	Value & Format	Description	Movie	Series	Season	Episode	Sport
`genres`	Array of String (min 1, unique)	Genres of the content, restricted to the allowed genre list below. Must include the `dominant_genre` value if one is set.	required	required	required	required	N/A
`dominant_genre`	String	Primary genre, from the same allowed genre list; drives category rows/filters.	optional	optional	optional	optional	N/A

Examples John Wick (Movie)

{
  "genres": ["Action", "Thriller"],
  "dominant_genre": "Action"
}

The Mandalorian (Series)

{
  "genres": ["Action", "Adventure", "Sci-Fi"],
  "dominant_genre": "Action"
}

Breaking Bad (Series)

{
  "genres": ["Crime", "Drama", "Thriller"],
  "dominant_genre": "Crime"
}

The Crown (Series)

{
  "genres": ["Drama", "History"],
  "dominant_genre": "Drama"
}

Chef’s Table (Series)

{
  "genres": ["Food & Cooking", "Documentary"],
  "dominant_genre": "Food & Cooking"
}

Allowed genres

genres and dominant_genre are restricted to the fixed list below — send only these Genre values (case as shown). Values outside this list are rejected.

Genre	Includes	Example
Action	Martial arts, superhero, action/adventure	John Wick (Movie) The Mandalorian (Series)
Adventure	Quests, survival, expeditions, road movies	Indiana Jones (Movie) The Rings of Power (Series)
Animation	Animated films & series, cartoons (excl. anime)	Toy Story (Movie) The Simpsons (Series)
Anime	Japanese-style animation, manga adaptations	Your Name (Movie) Attack on Titan (Series)
Comedy	Sitcom, dramedy, satire	The Hangover (Movie) The Big Bang Theory (Series)
Classic	Vintage/classic-era titles	Casablanca (Movie) I Love Lucy (Series)
Crime	Detective, police/legal, heist (fictional)	Heat (Movie) Breaking Bad (Series)
Drama	Coming-of-age, soap/telenovela, period, indie/arthouse	Forrest Gump (Movie) The Crown (Series)
Fantasy	Magic, fairy-tale worlds	The Lord of the Rings (Movie) Game of Thrones (Series)
History	Period fiction AND history documentaries (intentionally merged)	Gladiator (Movie) Vikings (Series)
Horror	Slasher, supernatural, occult, paranormal	The Conjuring (Movie) The Walking Dead (Series)
Mystery	Puzzles, ghost / unexplained	Knives Out (Movie) Sherlock (Series)
Romance	Rom-com, dating, weddings (fictional)	The Notebook (Movie) Bridgerton (Series)
Sci-Fi	Sci-fi, dystopia, space opera, AI / robots	Blade Runner (Movie) Doctor Who (Series)
Thriller	Suspense, film-noir	Se7en (Movie) Homeland (Series)
War	War films, military	Saving Private Ryan (Movie) Band of Brothers (Series)
Western	Western	Django Unchained (Movie) Yellowstone (Series)
Kids	Aimed directly at children (preschool, cartoons, fairy tales)	Paw Patrol: The Movie (Movie) Peppa Pig (Series)
Family	Aimed at families / all ages (family films, Disney)	The Lion King (Movie) Last Man Standing (Series)
Documentary	General / investigative documentary, reportage (fallback)	13th (Movie) The Last Dance (Series)
Science & Knowledge	Science, technology, space, education, how-to	An Inconvenient Truth (Movie) Cosmos (Series)
Nature & Wildlife	Nature, animals, environment	March of the Penguins (Movie) Planet Earth (Series)
True Crime	Real criminal cases, serial killers, justice (factual)	Amanda Knox (Movie) Making a Murderer (Series)
Biography	Biography, portrait, biopic docs	Senna (Movie) The Defiant Ones (Series)
Travel	Travel, destinations, culinary / extreme travel	A Map for Saturday (Movie) Parts Unknown (Series)
Food & Cooking	Cooking shows, culinary	Jiro Dreams of Sushi (Movie) Chef’s Table (Series)
Home, Garden & DIY	Home, garden, renovation, DIY, crafts	Grand Designs (Series) Fixer Upper (Series)
Health & Medicine	Health, medicine, fitness	Super Size Me (Movie) (Un)Well (Series)
News	Current affairs — politics, economics, society alike	BBC News (Series) CNN Newsroom (Series)
Arts & Culture	Art, culture, theatre, performing arts	Exit Through the Gift Shop (Movie) Abstract (Series)
Auto, Motor & Tech	Cars, motorcycles, engineering (opt.: under Science)	Williams (Movie) Top Gear (Series)
Business & Finance	Business, finance (opt.: under Documentary)	The Inventor (Movie) Shark Tank (Series)
Reality & Docutainment	Reality, docusoap, docutainment, competition (genuine)	Gold Rush (Series) Deadliest Catch (Series)
Scripted Reality	Staged in reality/doc style: court shows, pseudo-doc, doku-soap fiction	Made in Chelsea (Series) Judge Rinder (Series, UK)
Game & Quiz Show	Game & quiz shows	Jeopardy! (Series) Who Wants to Be a Millionaire (Series)
Talk & Late Night	Talk, late night, interview, variety/sketch (not infotainment magazine)	The Tonight Show (Series) Late Night w/ Seth Meyers (Series)
Fashion & Lifestyle	Fashion, beauty, coaching, shopping, celebrity	Queer Eye (Series) Keeping Up with the Kardashians (Series)
Sport (topic)	Sport TOPIC (sports magazine/doc/entertainment); live sport = content type Sport	The Two Escobars (Movie) Rocky (Movie) Drive to Survive (Series)
Music	Concert, opera, music documentary, singing/talent competitions	Taylor Swift: The Eras Tour The Voice (Series)
Musical	Song-and-dance driven narratives, stage-musical adaptations	Grease (Movie) Glee (Series)

dominant_genre fallback. If a record omits dominant_genre, TitanOS may fall back to the first entry in genres for UI placement — this is a fallback, not a substitute for setting the field explicitly, since it makes placement dependent on array order.

Type-specific fields

Field Name	Value & Format	Description	Movie	Series	Season	Episode	Sport
`duration_in_seconds`	`Integer` ≥ 0	Runtime in seconds (renamed from `duration`).	required	N/A	N/A	required	required
`total_seasons`	`Integer` ≥ 0	Total number of seasons.	N/A	optional	N/A	N/A	N/A
`total_episodes`	`Integer` ≥ 0	Total number of episodes (series-wide or within the season).	N/A	optional	optional	N/A	N/A
`tv_show_id`	String (content id)	Id of the parent series.	N/A	N/A	required	required	N/A
`season_id`	String (content id)	Id of the parent season.	N/A	N/A	N/A	required	N/A
`season_number`	`Integer` ≥ 0	Season number.	N/A	N/A	required	optional	N/A
`episode_number`	`Integer` ≥ 0	Episode number within the season.	N/A	N/A	N/A	required	N/A

Sport fields

Only for sport_program records.

Field Name	Value & Format	Description	Sport
`sport`	String	Discipline, e.g. `Football`.	required
`league`	String	e.g. `Primera Division`.	optional
`tournament`	String	e.g. `UEFA Champions League`.	optional
`competition_stage`	String	e.g. `group`, `quarter_final`, `semi_final`, `final`.	optional
`is_olympic`	`Boolean`	Whether the event is part of the Olympic Games.	optional
`gender`	`Enum`: `men`, `women`, `mixed`	Competition gender category.	optional
`event_type`	`Enum`: `match`, `highlight`, `magazine`, `press_conference`, `interview`	Kind of program.	optional
`competitors`	Array of Competitor (min 1)	Participating teams/players, each with a localised name.	optional
`home`	Competitor	Home side, for two-sided matchups.	optional
`away`	Competitor	Away side, for two-sided matchups.	optional
`location`	Object `{ country?, city?, venue? }`	Event location. `country` is an ISO code; `city`/`venue` are localised.	optional
`live`	Object `{ start_time?, end_time?, availabilities }`	Live broadcast block. Carries the live offers. See Live events and PPV.	optional

Availabilities

Instead of business models like AVOD, TVOD, and SVOD, an offer is now defined by three independent axes: offer_type (the payment mechanism), includes_ad (whether playback carries ads), and delivery — determined by where the offer lives rather than a field of its own (item-level availabilities = VOD, live.availabilities = live). Each entry describes exactly one offer: one payment mechanism, one market set, one time window. Never merge multiple markets or terms into a single entry.

Offer fields

Shared by VOD and live/sport offers.

Field	Value & Format	Description	Required
`offer_type`	VOD: `free`, `account`, `subscription`, `rental`, `purchase` · Live: `free`, `account`, `subscription`, `ppv`, `purchase`	Payment/access mechanism. Allowed set depends on context (VOD vs live).	required
`markets`	Array of ISO 3166-1 alpha-2 (min 1, unique)	Target markets (renamed from `market`).	required
`start_time`	`ISO 8601` / RFC 3339	Start of the watchable window.	required
`end_time`	`ISO 8601` / RFC 3339	End of the watchable window.	required
`video_qualities`	Array of `SD`, `HD`, `UHD`, `8K` (min 1, unique)	Qualities this offer includes (replaces single `video_quality`; `8K` added). VOD only — omit for live.	required (VOD)
`includes_ad`	`Boolean` (default `false`)	Whether playback carries ads. Orthogonal to `offer_type`.	optional
`requires_base_offer`	`Enum`: `subscription`, `account`	Entitlement the user must already hold (gated PVOD / gated PPV).	optional
`price`	Object `{ amount, currency }`	Transactional price (replaces separate `price` + `currency`). See rules below.	conditional
`license_duration`	`ISO 8601` duration, e.g. `PT48H`, `P2D`, `P14D`	Per-user playback window after the transaction.	conditional

price is { "amount": 4.99, "currency": "EUR" } — decimal major units (4.99, not 499; 500 for €500). amount ≥ 0, currency is ISO 4217.

Business model translation

The availabilities array describes one offer per entry — one payment mechanism × one market set × one time window. Never merge multiple markets/terms into a single entry; never send industry shorthand (SVOD, AVOD, TVOD, EST) — express it via offer_type + includes_ad.

Business model	`offer_type`	`includes_ad`	`requires_base_offer`	`price`	`license_duration`
Free, no sign-up	`free`	—	—	⛔ rejected	—
Free with ads (AVOD)	`free`	`true`	—	⛔ rejected	—
Free, login required	`account`	`true` if ads	—	⛔ rejected	—
Subscription (SVOD)	`subscription`	—	—	—	—
Subscription, ad tier	`subscription`	`true`	—	—	—
Rental (TVOD/RVOD)	`rental`	—	—	✓ required	optional, VOD only
Purchase (EST/DTO)	`purchase`	—	—	✓ required	—
Pre-order	`purchase`	—	—	✓ required	— (future `start_time`)
Gated rent/buy on top of subscription (PVOD)	`rental`/`purchase`	—	✓ `"subscription"`	✓ required	optional if rental
Pay-per-view live event (PPV)	`ppv` (live only)	—	—	✓ required	optional

Key rules

price required for rental/purchase/ppv; rejected for free/account.
license_duration only valid on rental and ppv; omit → bounded by end_time.
ppv = live-only; rental = VOD-only.
video_qualities required, VOD-only — omit on live offers.
price.amount is major units (4.99, not 499).

Live events and PPV

Live content (e.g. sport_program) keeps two separate offer lists:

Where	What it describes
`live.availabilities`	Offers for the live broadcast (uses `LiveOfferType`: `free`/`account`/`subscription`/`ppv`/`purchase`). No `video_qualities`.
item-level `availabilities`	Offers for the VOD replay only. Never put live info here.

The live object also carries the actual event schedule:

Field	Value & Format	Description
`live.start_time`	`ISO 8601` / RFC 3339	Scheduled event start (e.g. kickoff), not a broadcast time.
`live.end_time`	`ISO 8601` / RFC 3339	Scheduled event end.
`live.availabilities`	Array of live offers (required if `live` present)	Offers for the broadcast. Each offer’s own `start_time`/`end_time` is its stream window (pre-match coverage may start earlier than `live.start_time`).

Key rules. ppv = pay once for the live event (access ends with the broadcast; replay terms go in the VOD availabilities as rental/purchase). purchase on live = keep it permanently. On the VOD side, access that expires is rental (with license_duration), never purchase. For one payment covering live + replay, send an entry in both lists with the same price. Pre-sale needs no extra field — an offer in the feed is on sale now, even if its window is in the future.

Shared sub-objects

Image

Field	Value & Format	Required
`type`	`Enum`: `artwork_landscape`, `artwork_portrait`, `screenshot_landscape`, `screenshot_portrait`, `transparent_logo`	required
`url`	URI	required
`locales`	Array of BCP 47 locale tags (min 1, unique)	required
`aspect_ratio`	String `"W:H"`, e.g. `"16:9"`, `"2:3"`	optional

Core delivery rules

Format & Compatibility: All images must be delivered in JPEG or PNG format using the sRGB color space.
Asset Availability: Artwork must be hosted on a stable, public-facing server (HTTPS) that allows the TitanOS ingestion system to download the files.
Update Logic: If you change an image, you must update the image URL or the metadata timestamp. Our system caches images, so keeping the same URL for a new image will prevent the UI from updating.
Resolution & Scaling: Always provide the highest required resolution. Images will be scaled down for lower-end devices, but low-resolution source files may be rejected to avoid pixelation on 4K displays.

UI safe zones. When preparing artwork, keep primary visual elements (such as faces or titles) centered. TitanOS may overlay text or other UI elements on the edges of the image.

Providing assets that do not match the required aspect ratios (e.g., sending a 4:3 image for a 16:9 slot) will result in automatic cropping or padding, which may distort the intended look of your content.

Minimum resolution by type

`type`	Aspect ratio	Minimum width	Recommended width
`artwork_landscape`	16:9	640px	960px+
`screenshot_landscape`	16:9	1920px	3840px
`artwork_portrait`	2:3	400px	800px+
`screenshot_portrait`	2:3	640px	960px+
`transparent_logo`	—	400px	640px+

Examples artwork_portrait

screenshot_portrait

artwork_landscape

screenshot_landscape

transparent_logo

Transparent logo example

PromoVideo

Same as Image but type is trailer / clip / preview, and it adds optional duration_in_seconds (integer ≥ 0). Required: type, url, locales.

Deeplink

Field	Value & Format	Required
`platform`	`Enum`: `web`, `android`, `ios`, `tv`	required
`action`	`Enum`: `detail`, `watch`	required
`url`	URI	required
`markets`	Array of ISO 3166-1 alpha-2 (min 1, unique)	required

At least one deeplink per record must have platform: "tv". Technical preconditions. To ensure a successful integration, your application and metadata must meet the following standards:

HTML5 Accessibility: The application must be a web-based app accessible via a stable URL.
Routing Logic: For Single Page Applications (SPAs), the internal routing must be configured to parse incoming URL paths or parameters and resolve the correct view state immediately.
Destination Targets: We support and recommend two levels of deep linking — Content Details (leads the user to the movie or series overview page) and Direct Player, recommended (navigates the user directly into the video player to start playback).
Geoblocking: Since TitanOS is a global platform, ensure the deep link provided for a specific market (e.g., ES) is not geoblocked for users in that region.

URL construction & structure. For HTML5 applications, the final landing URL is created by appending the content-specific path provided in your metadata to the application’s registered Base URL. The formula: {AppBaseURL} + / + {path} — e.g. base https://titanos.partner-app.com + path player/550e8400-e29b → https://titanos.partner-app.com/player/550e8400-e29b. Query-parameter routing (…/launch?content_id=998877&autoplay=true) works the same way — the url field just needs to resolve to the right view. action semantics

detail (Content Details Page): navigates the user to the informational overview or landing page of the asset. Mandatory for tv_show and season, as they are containers rather than playable video files.
watch (Direct Player Launch): bypasses all menus and launches video playback immediately. Strongly preferred for movie and individual episode records to keep the user journey as short as possible.

{
  "platform": "tv",
  "action": "watch",
  "url": "https://titanos.partner-app.com/player/550e8400-e29b",
  "markets": ["ES"]
}

The final deeplink structure depends on the architecture of the CTV application. The instructions and examples might not work 1:1 with your CTV application.

Classification

Field	Value & Format	Required
`minimum_age`	`Integer` 0–21	required
`markets`	Array of ISO 3166-1 alpha-2 (min 1, unique)	required
`system`	String, e.g. `FSK`, `BBFC`, `MPAA`	optional
`code`	String, e.g. `PG-13`, `12A`	optional

Common system/code reference

Country	`system`	Example `code` values	`minimum_age`
Germany	`FSK`	FSK0, FSK6, FSK12, FSK16, FSK18	0, 6, 12, 16, 18
UK	`BBFC`	U, PG, 12A, 15, 18	0, 8, 12, 15, 18
Spain	`ICAA`	TP, 7, 12, 16, 18	0, 7, 12, 16, 18
USA	`MPAA`	G, PG, PG-13, R, NC-17	0, 10, 13, 17, 18

classifications is optional in the current schema — but TitanOS may still withhold publication of content lacking a valid age rating to manage legal risk, so provide it wherever available.

Identifier

Field	Value & Format	Required
`platform`	`Enum`: `imdb`, `tmdb`, `eidr`, `gracenote`, `rotten-tomatoes`, `wikidata`, `allocine`	required
`value`	String, e.g. `tt0137523`	required

Credits

credits is an array of { role, locale, name, character_name? }, one entry per (role, locale, name).

Field	Value & Format	Required
`role`	`Enum`: `actor`, `voice_actor`, `director`, `writer`, `producer`, `host`, `narrator`, `presenter`, `guest`, `sign_interpreter`, `player`, `coach`, `head_coach`, `referee`, `commentator`, `announcer`, `analyst`	required
`locale`	BCP 47 locale tag	required
`name`	String	required
`character_name`	String	optional — only allowed when `role` is `actor` or `voice_actor`

Competitor

{ name } where name is an array of { locale, value } localised strings (min 1).

Sport location

{ country?, city?, venue? } — country is an ISO 3166-1 alpha-2 code (not localised); city and venue are each arrays of { locale, value }.

Value types used above

Locale tag — BCP 47: language + optional script + optional region (e.g. en, de-DE, es-419).
Market code — ISO 3166-1 alpha-2 (e.g. US, DE).
Currency code — ISO 4217 alpha-3 (e.g. EUR, GBP, USD).
Localised text/title — { locale, value } or { locale, title }.

Recommendations

Defined in recommendations.schema.json. A separate full-snapshot document: one ordered list per market set, referencing content ids from your feed. Absence = delete (an id in no list is no longer recommended). Ids not present in the content feed are ignored. Emit generated_at before recommendations.

Field	Value & Format	Description	Required
`schema_version`	String, semver, `"1.1.0"`	Recommendations schema/contract version.	required
`generated_at`	`ISO 8601` / RFC 3339 UTC	When this snapshot was generated.	required
`recommendations`	Array of lists (min 1)	One entry per market set. Use separate entries when the ranking differs between countries.	required
`recommendations[].markets`	Array of ISO 3166-1 alpha-2 (min 1, unique)	Markets this list applies to.	required
`recommendations[].items`	Array of `{ id, position }` (min 1)	Ranked items.	required
`…items[].id`	String (content id)	Matches `id` in the content feed.	required
`…items[].position`	`Integer` ≥ 1	Explicit rank; 1 = top. Order is defined by `position` only, never array order. Positions must be unique within a list; gaps are allowed and preserved as relative order.	required

Changelog

v1.1.0 — 2026-09-16 — Closed genre taxonomy (additive)

schema_version is one shared contract version across feed.schema.json, content.schema.json, and recommendations.schema.json — all three now declare "1.1.0", even though only the genre taxonomy changed. A 1.0.0 feed still validates against the 1.1.0 schema (MINOR = additive).Genres

Old (schema v1.0.0)	New (schema v1.1.0)
`genres` / `dominant_genre` accepted any string	Closed enum, `$defs/Genre` (41 values) — see Allowed genres. Any other value is rejected.
`Science Fiction (Sci-Fi)` accepted as a spelling	Only `Sci-Fi` is accepted.

v1.0.0 — 2026-07-24 — Full schema rewrite (breaking)

New documents

Old (previous site spec)	New (schema v1.0.0)
(no feed envelope)	New `feed.schema.json` wrapper: `schema_version`, `generated_at`, `mode: "full"`, `contents`. Absence = delete.
(no recommendations document)	New `recommendations.schema.json`: per-market ranked lists keyed by `position`.

Availabilities / offers

Old (previous site spec)	New (schema v1.0.0)
`availabilities[].business_model` (`AVOD`/`HVOD`/`RVOD`/`TVOD`/`SVOD`/`EST`)	`offer_type` + `includes_ad` + `requires_base_offer` (see Availabilities).
`availabilities[].market`	`availabilities[].markets`
`availabilities[].price` (number) + `…currency` (separate)	`price` object `{ amount, currency }`; amount in decimal major units
`availabilities[].video_quality` (single `SD`/`HD`/`UHD`)	`video_qualities` array; `8K` added
`availability_start` / `availability_end` (optional)	`start_time` / `end_time` — now required
(none)	New `requires_base_offer`, `license_duration`; live offers split into `live.availabilities` with `ppv`

Content fields (general)

Old (previous site spec)	New (schema v1.0.0)
`duration` (seconds; sport optional)	`duration_in_seconds`; required for movie, episode, sport; not present on series/season
`original_title` (string)	`original_title` object `{ locale?, title }`
`synopses` (single array, “min 200 chars”)	`short_synopses` (≤512) / `medium_synopses` (≤1024) / `long_synopses` — at least one required
`deeplinkings` `{ market, action, device_type:"TV", url }`	`deeplinks` `{ platform (web/android/ios/tv), action (detail/watch), url, markets }`; ≥1 `tv` required
5 separate artwork/screenshot/logo fields	one `images` array with `type`; ≥1 `artwork_landscape`/`artwork_portrait` required
`actors` + `directors`	`credits` with a full `role` enum + optional `character_name`
`external_id` `{ type: imdb \| tmdb, id }`	`identifiers` `{ platform, value }` (imdb, tmdb, eidr, gracenote, rotten-tomatoes, wikidata, allocine)
`classifications[].country` + required	`classifications[].markets` (array); classifications now optional
`created_at` / `updated_at` required	now optional
`year` required	now optional (range 1888–2250)

Series / season / episode structure

Old (previous site spec)	New (schema v1.0.0)
`series_info[]` `{ total_numbers_seasons, total_numbers_episodes }`	flat `total_seasons` / `total_episodes` on the series (both optional)
`season_info[]` `{ parent_series_id, season_number, total_number_episodes }`	flat `tv_show_id`, `season_number`, `total_episodes` on the season
`episode_info[]` `{ parent_series_id, parent_season_id, season_number, episode_number }`	flat `tv_show_id`, `season_id`, `season_number?`, `episode_number` + required `duration_in_seconds`

Sport fields

Old (previous site spec)	New (schema v1.0.0)
`sport_event_info[]` wrapper	flat sport fields on the record (see Sport fields)
`sport…discipline` / `sub_discipline`	`sport`; `sub_discipline` removed
`sport…gender` (`male`/`female`/`mixed`)	`gender` (`men`/`women`/`mixed`)
`sport…type_of_event` (7 values incl. `documentary`, `full_event_replay`)	`event_type` (`match`, `highlight`, `magazine`, `press_conference`, `interview`)
`competitor_home` / `competitor_away`	`home` / `away` (+ `competitors[]`)
`sport…location` `{ country, city, venue }` (strings)	`location` with ISO `country` + localised `city`/`venue` arrays
`sport…live_timeline` `{ start_time, actual_start_time, end_time, status, is_restart_enabled }`	`live` `{ start_time?, end_time?, availabilities }` — `status`, `actual_start_time`, `is_restart_enabled` removed; live now carries offers

Get Started

Basics

Titan SDK

Advanced

Performance

Testing & Debugging

Metadata

FAST Channels

Partner Portal & FAQ

Feed envelope

Content record

Base fields

Genre fields

Allowed genres

Type-specific fields

Sport fields

Availabilities

Offer fields

Business model translation

Live events and PPV

Shared sub-objects

Image

PromoVideo

Deeplink

Classification

Identifier

Credits

Competitor

Sport location

Value types used above

Recommendations

Changelog

​Feed envelope

​Content record

​Base fields

​Genre fields

​Allowed genres

​Type-specific fields

​Sport fields

​Availabilities

​Offer fields

​Business model translation

​Live events and PPV

​Shared sub-objects

​Image

​PromoVideo

​Deeplink

​Classification

​Identifier

​Credits

​Competitor

​Sport location

​Value types used above

​Recommendations

​Changelog

Feed envelope

Content record

Base fields

Genre fields

Allowed genres

Type-specific fields

Sport fields

Availabilities

Offer fields

Business model translation

Live events and PPV

Shared sub-objects

Image

PromoVideo

Deeplink

Classification

Identifier

Credits

Competitor

Sport location

Value types used above

Recommendations

Changelog