Streaming Availability APIs

Resolve one known movie or series using a show ID, an IMDb ID such as tt0120338, or a TMDB ID such as movie/597 or tv/1396. Set country to a supported lowercase two-letter code to restrict viewing options to that market; omit it to request availability across supported countries. The response is a single raw show object, not a result list. The observed Titanic lookup returned itemType, showType, id, imdbId, tmdbId, title, originalTitle, overview, releaseYear, genres, directors, cast, rating, runtime, imageSet and streamingOptions.us. Viewing-option entries included service, type, link, audio and subtitle information, with quality, price, add-on or availability dates where supplied. Group links by type rather than treating rentals, purchases and add-ons as included subscriptions. A known title may have no viewing options in a particular country. series_granularity controls documented series detail: show omits season and episode data, season includes seasons, and episode includes both. The default here is episode; use show when only title-level availability is needed. Links lead to streaming-service pages and do not bypass their access requirements.

Provide a title phrase and a supported lowercase country code to find candidate movies and series. Optionally restrict show_type to movie or series; leaving it unset searches both. The response is a raw array of show objects, with no shows wrapper or cursor pagination. The observed Titanic movie search returned 20 candidates, including Titanic (1997), with id, imdbId, tmdbId, title, originalTitle, releaseYear, overview, genres, directors, cast, rating, runtime, imageSet and country-keyed streamingOptions. Matching uses title and show type, so a result can exist without being streamable in the requested country. Check each candidate's identity and streamingOptions before displaying a where-to-watch link. The documented limit is normally 20 results, except that all exact-title matches can be returned when there are more than 20. series_granularity affects series only: show omits season and episode detail, season includes seasons, and episode includes both. Use the catalog search instead when you need paginated browsing.

Search available movies and series in one required country. catalogs accepts up to 32 comma-separated filters: a service ID such as netflix, a service plus access type such as prime.subscription, or service.addon.addon_id using an add-on ID from the country directory. A bare service ID includes its supported viewing types, not just subscription-included titles; multiple catalogs match any listed catalog. Omit catalogs to search all available catalogs in that country. Combine genre IDs from get-genres using genres_relation=and or or, match a keyword in the title or overview, restrict original language, and set year or rating bounds. order_by supports title, release date, rating and the listed popularity periods; use order_direction=desc for highest-rated results first. The observed US Netflix movie request returned a raw object with shows, hasMore and nextCursor. Each show contained identifiers, title, releaseYear, overview, genres, cast, rating, runtime, imageSet and streamingOptions.us, potentially including services beyond the selected catalog. Follow nextCursor only when hasMore is true and preserve every other filter. The observed nonexistent keyword returned exactly shows:[] and hasMore:false, with no nextCursor. Movie or show-level pages contain 20 results; documented series page sizes vary with series_granularity. This endpoint returns discovery metadata and service links, not playable media.

Poll catalog changes for a required country, change_type and item_type. Documented change types are new, removed, updated, expiring and upcoming; item types are show, season and episode. Use show_type to narrow show-level changes to movies or series. Optional catalogs uses the same service, service.access_type and service.addon.addon_id syntax as catalog search, with up to 32 comma-separated catalogs. The observed new/show request for Netflix US returned a raw object containing changes, a shows map keyed by show ID, hasMore and nextCursor. Change entries included changeType, itemType, showId, showType, streamingOptionType, service, link and timestamp; join showId to the shows map for title metadata and viewing options. Pages contain up to 25 changes ordered by timestamp, with order_direction selecting ascending or descending order. Pass from and to as inclusive Unix timestamps in seconds: new, removed and updated changes are limited to the past 31 days, while expiring and upcoming changes use the next 31 days. Omitted bounds span the corresponding documented window. Future dates may be unknown; include_unknown_dates controls whether those entries are included and does not affect past changes. Continue with nextCursor only when hasMore is true, keeping all other parameters unchanged. This is a polling feed, not a webhook or an unlimited historical archive; future-date coverage is not guaranteed for every service.

Fetch the supported-country directory, optionally choosing output_language from en, es, tr or fr. The response is a raw object keyed by lowercase country code, not an array or a countries wrapper. Each entry contains countryCode, name and a services array. Observed service objects contained id, name, homePage, themeColorCode, imageSet, streamingOptionTypes and addons; add-ons supplied their own IDs, names, home pages and artwork metadata. The observed directory included the United States with Netflix, Prime Video, Disney+, Hulu and other services. Use the returned country and service IDs when building catalog requests rather than freezing a country count or assuming that a service operates in every market. streamingOptionTypes describes a service's supported access types, not the availability of an individual movie or series. This directory does not return title-level catalogs or viewing links for a selected show.

Pass a supported lowercase country-code path value, such as us, to retrieve one market's service directory. output_language selects en, es, tr or fr, with English as the default. The response is a single raw object with countryCode, name and services. The observed US response identified United States and included Netflix plus other regional services. Service entries contained id, name, homePage, themeColorCode, imageSet, a streamingOptionTypes object with boolean access-type flags, and an addons array. Add-on entries contained id, name, homePage, themeColorCode and imageSet. Use these service and add-on IDs to construct catalog selectors such as service.subscription or service.addon.addon_id. An empty addons array means no channels are listed for that service in this response. A supported access type is a directory capability, not evidence that a particular title is watchable. For a movie or series, resolve its identity and read its own streamingOptions.

Fetch the supported movie and TV genre taxonomy with optional output_language set to en, es, tr or fr. The response is a raw array of objects containing id and name, with no pagination or enclosing genres field. The observed English response contained 21 pairs, including action/Action, comedy/Comedy, drama/Drama and scifi/Science Fiction. Use id values in the catalog search's comma-separated genres parameter, and use name for display rather than submitting translated labels as filter values. This endpoint returns the genre reference only, not matching titles, popularity rankings or per-genre catalog counts. A separately translated Chinese interface can display its own labels, but Chinese is not one of the documented output_language options.