Get one movie or series by internal, IMDb or TMDb id with global streaming availability
View all Streaming Availability endpoints →Returns the details of a single show, together with its streaming availability, looked up by the id path value. The id can be the internal show id, an IMDb id (tt followed by digits, for example tt0120338 for Titanic) or a TMDb id written as movie/<number> for movies or tv/<number> for series (for example movie/597 or tv/1396); the type of id is detected automatically. Optional query inputs are country, output_language and series_granularity. country is an ISO 3166-1 alpha-2 code: when it is omitted, availability across all countries is returned, and when it is supplied only that country is included, which is the recommended way to get a smaller, faster response. output_language accepts en, es, tr or fr (default en). series_granularity accepts show, season or episode and only affects series; its default on this endpoint is episode, so choose show if you do not need season and episode info. Observed in a sample call (id tt0120338, country us, series_granularity show): HTTP 200 with a single JSON object for the movie Titanic (internal id 136). It exposed itemType, showType, id, imdbId, tmdbId, title, originalTitle, overview, releaseYear, genres (id and name pairs), directors, cast, rating, runtime, imageSet and streamingOptions. streamingOptions was an object keyed by country code (only us in the sample) whose entries had service, type, link, audios, subtitles, expiresSoon and availableSince, plus quality on most entries; the types seen were subscription, free, rent, buy and addon, rent and buy entries added a price object (amount, currency, formatted), and some entries added expiresOn or videoLink. Not exercised by the sample call: the TMDb id form, calling without country, and the documented 404 error body, which the source documentation shows as a JSON object with a message field.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/streaming-availability/get-show API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/get-show?key=<API_KEY>&id=<id>&output_language=en&series_granularity=episode'
Query Result
Use Cases
- Where-to-watch widget on a review or news page, keyed by the IMDb id already in the article metadata
- Cross-country availability matrix for one title, built by calling without country and grouping by country code
- Nightly refresh of a saved watchlist row by id to spot when a new service starts streaming the title
- Budget view that keeps only free and subscription option types and hides rent and buy rows
- Enriching a media-server library item with the services that carry the same title in other regions
- Series detail page that links viewers straight to individual seasons and episodes through deep links
Frequently asked questions
Which id formats does Get Show accept in the id path value?
The internal show id, an IMDb id in the form tt followed by digits (for example tt0120338), or a TMDb id written as movie/<number> for movies and tv/<number> for series (for example tv/1396). The type is detected automatically. The sample call used the IMDb form; the TMDb form is documented but was not probed, and because it contains a slash you should make sure your client sends it as intended.
What happens if I leave out the country parameter?
According to the documentation, the response then contains streaming availability across all countries instead of one. Passing country limits it to that market and is recommended when you need a single country, since the response is smaller and faster. The sample call passed country us and returned a streamingOptions object with only the us key.
Why does series_granularity default to episode here but to show on search?
The two endpoints define different defaults. Here episode is the default, so series responses include season and episode info with deep links unless you pass show or season. Movies are not affected. The sample call set it to show on a movie.
What fields does the show object contain?
In the sample call: itemType, showType, id, imdbId, tmdbId, title, originalTitle, overview, releaseYear, genres, directors, cast, rating, runtime, imageSet and streamingOptions. The Titanic response listed James Cameron under directors and genres as id and name pairs such as drama and romance.
How do I show only free or subscription options?
There is no server-side filter for it on this endpoint. Each entry in streamingOptions has a type, and the sample returned subscription, free, rent, buy and addon, so filter on that field in your own code. Rent and buy entries carry price, and addon entries carry an addon object naming the channel.
How can I tell when an option is about to disappear?
Every option in the sample had an expiresSoon boolean and an availableSince timestamp, and some also had expiresOn. Store these fields and compare them across refreshes to spot titles that are leaving a service.
What does a missing show return?
The source documentation shows a 404 example whose body is a JSON object with a message field (empty in the example). This was not triggered by the sample call, so treat the exact error text as unverified.
Do the image URLs in the response last forever?
No. The image links in the sample carried Expires and Signature query values, so re-request the show rather than storing them permanently. The imageSet has verticalPoster, horizontalPoster, verticalBackdrop and horizontalBackdrop in several widths.