Search movies and series by title with streaming options for one country

View all Streaming Availability endpoints →

Searches movies and series by a title phrase and returns a JSON array of matching shows, each with the streaming availability for the country you choose. Two inputs are required: country (an ISO 3166-1 alpha-2 code such as us; the countries endpoint lists the supported ones) and title (the phrase to search). Optional inputs are show_type, which restricts the search to one kind of show (the sample call used movie; omit it to search movies and series together), output_language (en, es, tr or fr, default en) and series_granularity (show, season or episode, default show; it only affects series, and show keeps the response smallest). At most 20 items are returned, unless more than 20 shows have exactly the given title, in which case all exact matches are returned. There is no pagination. Availability is included only for the requested country, and a hit may not be streamable there, because the title and show type are the only search criteria. Observed in a sample call (country us, title batman, show_type movie, series_granularity show): HTTP 200 with a root array of 20 show objects. Each object exposed itemType, showType, id, imdbId, tmdbId, title, originalTitle, overview, releaseYear, genres (id and name pairs), directors, cast, rating, imageSet and streamingOptions; 19 of the 20 also carried runtime. streamingOptions was an object keyed by country code (us in the sample) holding option entries with service, type, link, quality, audios, subtitles, expiresSoon and availableSince; rent and buy options added a price object (amount, currency, formatted), and some options added expiresOn, videoLink or addon. The documentation does not enumerate show_type values beyond the movie example, and only movie results were exercised in the sample call.

API Features

Title phrase matching with a 20-item cap Send a free-text title and get up to 20 shows back; when more than 20 shows share exactly that title, every exact match is returned instead of a truncated list.
Country-scoped streamingOptions per hit Each result carries streamingOptions keyed by the country you requested, with service, option type, deep link, quality, audios, subtitles and a price object on rent and buy entries.
Movie or series scope through show_type Pass show_type to narrow the search to one kind of show, or leave it out so movies and series are searched together in a single call.
Depth control for series results series_granularity switches between show, season and episode detail for series hits; the default show keeps the response small and movies are never affected.
Ids ready for follow-up lookups Every hit includes the internal id plus imdbId and tmdbId, so a chosen result can be passed straight to the single-show endpoint for cross-country availability.
Output text in four languages output_language accepts en, es, tr or fr to choose the language of the returned text, with en as the default.

Live API Demo

GET /api/project/streaming-availability/search-shows-by-title

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/search-shows-by-title?key=<API_KEY>&country=<country>&output_language=en&series_granularity=show&title=<title>'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

How many results does Search Shows by Title return, and can I page through them?

At most 20 items come back, unless more than 20 shows have exactly the given title, in which case all exact matches are returned. Pagination is not supported. The sample call for batman returned a root array of 20 shows.

Is streaming availability included for every country?

No. Only the country you pass in the country parameter is covered, and streamingOptions is keyed by that country code (us in the sample). To compare regions for one title, take its id from this search and call the single-show endpoint without a country.

Why can a result come back with an empty streamingOptions object?

The title and show type are the only search criteria, so shows that are not streamable in the target country can still match. In the sample call one of the 20 results, a 1966 Batman movie, had an empty streamingOptions object for us.

Which streaming option types and fields can appear?

The sample returned the types subscription, rent, buy, free and addon. Every option had service, type, link, audios, subtitles, expiresSoon and availableSince; most had quality. Rent and buy options carried price with amount, currency and formatted; some options also had expiresOn, videoLink or an addon object naming the add-on channel.

What should I pass for show_type?

It is optional. The sample call used movie, and when the parameter is omitted both movies and series are searched. The supplied documentation gives movie as the only example value and does not list others, so check the response showType field if you filter by it.

What does series_granularity change on this endpoint?

It only affects series. show leaves out season and episode info, season adds season info without episodes, and episode adds both along with episode deep links. The default is show, which gives the smallest and fastest response. Movies are unaffected, and the sample call (all movies) used show.

Do the image links in the response expire?

The image links in the sample response carried Expires and Signature query values, so treat them as time-limited and re-request the show instead of storing the URLs long term. The imageSet had verticalPoster, horizontalPoster, verticalBackdrop and horizontalBackdrop, each in several widths such as w360 and w720.

Related operations

Guides

View Subscription Plans →