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
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/search-shows-by-title 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>'
Query Result
Use Cases
- Type-ahead search box in a watchlist app that lists the streaming services for each title the user types
- Chat bot /watch command that returns the top title matches together with the services available in the asker's country
- Telling remakes and same-name titles apart by releaseYear and showType before saving a show id
- Batch job that resolves a CSV of movie names into imdbId and tmdbId values
- Flagging titles that match by name but come back with no streaming options in the target country
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.