justwatch.com APIjustwatch.com ↗
Search movies and TV shows, get streaming availability, browse trending titles, and find similar content via the JustWatch API. 6 endpoints.
curl -X GET 'https://api.parse.bot/scraper/1e818686-70d7-4a06-b078-9c469784a890/search_titles?limit=5&query=Jaws' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for movies and TV shows by title query. Returns matching titles with basic streaming availability information.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return. |
| queryrequired | string | The search query for title name. |
{
"type": "object",
"fields": {
"data": "array of title objects with id, type, title, year, path, poster, streaming_on, watch_url",
"status": "string indicating success"
},
"sample": {
"data": [
{
"id": "tm123933",
"path": "/in/movie/jaws",
"type": "MOVIE",
"year": 1975,
"title": "Jaws",
"poster": "/poster/187613044/{profile}/jaws.{format}",
"watch_url": "https://www.hotstar.com/in/1971000506",
"streaming_on": "JioHotstar"
}
],
"status": "success"
}
}About the justwatch.com API
The JustWatch API covers 6 endpoints for querying streaming availability, title metadata, and content discovery across JustWatch's catalog. The search_titles endpoint returns matching movies and TV shows with per-title streaming_on and watch_url fields, while get_title_details exposes cast, genres, runtime, age rating, IMDb scores, and full streaming offers for a specific slug.
What the API Returns
The six endpoints cover title search, detailed metadata, trending content, similar-title recommendations, and reference data for providers and genres. search_titles accepts a query string and optional limit, returning an array of title objects that include id, type (movie or TV show), year, poster, streaming_on (current services carrying the title), and a watch_url. The path field in each result is what you pass as the slug parameter to other endpoints.
Title Details and Streaming Offers
get_title_details takes a slug such as movie/jaws or a full regional path like /in/movie/jaws and returns a detailed object: description, runtime, genres, age_rating, countries, backdrop, original_title, IMDb and/or audience scores, and the full set of streaming offers broken down by provider. This is the endpoint to use when you need to distinguish between subscription, rental, and purchase availability.
Discovery and Reference Endpoints
browse_popular_titles returns a ranked list of currently trending titles — useful for "what's popular now" features — with id, type, title, year, path, and poster per item. get_similar_titles accepts a reference slug and returns comparable content using the same response shape. Two reference endpoints, list_providers and list_genres, return lookup tables: providers include id, packageId, clearName, and shortName; genres include id, shortName, and translation. These are useful for mapping IDs found in detail responses back to human-readable names.
- Display where to stream a specific movie or show across all available services using
streaming_onfromsearch_titles. - Build a streaming availability tracker that checks
get_title_detailsoffers to surface rental vs. subscription options. - Populate a 'trending now' section in a media app using
browse_popular_titlesranked results. - Recommend related content on a title page by calling
get_similar_titleswith the current title's slug. - Map provider IDs in detail responses to display names using the
list_providersreference endpoint. - Filter or categorize a content catalog by genre using IDs from
list_genresmatched against title metadata. - Aggregate IMDb scores and runtime data from
get_title_detailsfor a cross-title comparison tool.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does JustWatch have an official developer API?+
What streaming availability data does `get_title_details` return, and does it distinguish offer types?+
get_title_details response includes a full streaming offers object that differentiates between availability types — subscription, rental, and purchase — along with the provider details. The list_providers endpoint gives you the mapping from provider IDs to names like clearName and shortName.Does the API support filtering by country or region?+
slug parameter in get_title_details (e.g. /in/movie/jaws for India), so the detail endpoint has some regional support. The search_titles and browse_popular_titles endpoints do not expose a country filter parameter. You can fork the API on Parse and revise it to add region filtering to those endpoints.Can I filter `browse_popular_titles` by genre or content type?+
browse_popular_titles accepts only an optional limit parameter and returns a ranked trending list without genre or type filters. list_genres provides the available genre reference data. You can fork the API on Parse and revise it to add genre or content-type filtering to the browse endpoint.Does the API expose episode-level data for TV shows?+
get_title_details returns show-level metadata including type, description, genres, and streaming offers, but individual season or episode details are not part of the response schema. You can fork the API on Parse and revise it to add an endpoint for episode-level data.