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

Internal, IMDb and TMDb ids in one path slot The id segment auto-detects an internal id, an IMDb id such as tt0120338, or a TMDb id such as movie/597 or tv/1396, so you can look a title up with whichever id you already store.
Optional country filter for lean responses Supplying country limits streamingOptions to that one market, which the documentation recommends when you only care about a single country.
Worldwide availability when country is omitted Leave country out and the response covers streaming availability across all countries, giving a cross-region picture of one title in a single request.
Full title record with credits and artwork Alongside availability you get overview, releaseYear, genres, directors, cast, rating, runtime and a four-part imageSet of vertical and horizontal posters and backdrops.
Per-option fields for deep links and expiry Each option has the service, a link, optional videoLink, quality, audio and subtitle lists with closed-caption flags, plus expiresSoon, availableSince and sometimes expiresOn.
Episode-level detail by default for series series_granularity defaults to episode here, adding season and episode streaming info with deep links; switch to show or season to trim the payload.

Live API Demo

GET /api/project/streaming-availability/get-show

Request cost is temporarily unavailable. No price is assumed.

View pricing

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'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →