流媒体目录研究
Use JustWatch endpoints to turn 流媒体目录研究 into repeatable API requests with documented inputs and JSON responses.
使用规范化 JSON 从 JustWatch 研究流媒体目录、片名可用性、供应商、片源、季、集和上线变化情况。
通过文档化的 API 端点采集 JustWatch 的片名搜索、流媒体可用性、供应商、类型、片源、季、集及目录发现数据。
Endpoint families
6
Documented params
93
Examples
21
Live catalog snapshot
Active endpoints
21
Methods
GET
Required params
34
Schema refs
21
{
"platform": "JustWatch",
"endpoint": "justwatch-search",
"method": "GET",
"path": "/justwatch/search",
"auth": "apiKey"
}Related use cases
Use cases
通过文档化的 API 端点采集 JustWatch 的片名搜索、流媒体可用性、供应商、类型、片源、季、集及目录发现数据。
Use JustWatch endpoints to turn 流媒体目录研究 into repeatable API requests with documented inputs and JSON responses.
Use JustWatch endpoints to turn 片名可用性监控 into repeatable API requests with documented inputs and JSON responses.
Use JustWatch endpoints to turn 供应商和片源情报 into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live JustWatch endpoint catalog — 21 endpoints, 93 documented request parameters, and 21 published response schemas — the same catalog Docs and Playground run against.
21 documented JustWatch endpoints, grouped into 14 request families — Title, Episode and Season, plus 11 more.
93 request parameters are documented across those JustWatch endpoints, 34 of them required — the full input contract is public before you write any integration code.
21 of the 21 JustWatch endpoints ship a recorded example response, and 21 carry a documented response schema — you can code against the real JSON before the first request.
JustWatch endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
21 hosted MCP tools back the JustWatch endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/justwatch/title
/justwatch/episode/by-id
/justwatch/season/episodes
/justwatch/age-certifications
/justwatch/discover
/justwatch/genre/titles
Featured endpoints
/justwatch/searchSearches JustWatch titles using the public credential-free website GraphQL endpoint. Country must be a two-letter ISO code such as `US`; language must be a two-letter code such as `en`.
Response notes
- Empty search results return `404`. - Invalid country or language formats return `400`. - GraphQL errors, block pages, malformed payloads, or upstream transport failures return `503`. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "inception", "country": "US", "language": "en", "results": [ { "id": "tm92641", "object_id": 92641, "object_type": "MOVIE", "title": "Inception", "year": 2010, "path": "/us/movie/inception", "url": "https://www.justwatch.com/us/movie/inception", "poster_url": "https://images.justwatch.com/poster/302449148/s718/inception.jpg" } ] } } ```
MCP tool justwatch_search
/justwatch/popularReturns popular movies and shows from the public JustWatch website GraphQL endpoint. Type accepts only `all`, `movie`, or `show`; limit defaults to 20 and clamps to 50.
Response notes
- Invalid `country`, `language`, or `type` values return `400`. - GraphQL errors, challenge payloads, malformed JSON, or unexpected empty popular payloads return `503`. - Results reuse the normalized title search shape and include compact offers when available.
MCP tool justwatch_popular
/justwatch/newReturns newly available movies and shows from the public JustWatch website GraphQL endpoint. Type accepts only `all`, `movie`, or `show`; limit defaults to 20 and clamps to 50.
Response notes
- Invalid `country`, `language`, or `type` values return `400`. - GraphQL errors, challenge payloads, malformed JSON, or unexpected empty new-title payloads return `503`. - Results are filtered to movie/show object types and reuse the normalized title search shape.
MCP tool justwatch_new
/justwatch/discoverReturns popular movies and shows filtered by optional genre short names, provider short names, production countries, monetization types, and release year bounds. Combine `providers` with `production_countries` to build charts such as most popular Korean or Japanese titles on a given service. Type accepts only `all`, `movie`, or `show`; monetization_types accepts only `FLATRATE`, `FREE`, `ADS`, `RENT`, or `BUY`.
Response notes
- Invalid `country`, `language`, `type`, `genres`, `providers`, `production_countries`, `monetization_types`, `year_min`, or `year_max` values return `400`. - `production_countries` filters on the title's country of origin (JustWatch popularity within a `country` market), not the market itself. Use `country` for the market and `production_countries` for the origin. - Each result carries a `production_countries` array so callers can confirm the origin used for the filter. - GraphQL errors, challenge payloads, malformed JSON, or unexpected empty discover payloads return `503`. - Provider short names can be discovered with `/api/v1/justwatch/providers`; genre short names can be discovered with `/api/v1/justwatch/genres`.
MCP tool justwatch_discover
/justwatch/titleFetches a JustWatch title page and returns normalized metadata and current offers. Pass exactly one of `path` or `url`.
Response notes
- Non-JustWatch URLs, missing locators, or both locators return `400`. - Missing title pages return `404`. - Block pages, malformed HTML, missing JSON-LD payloads, or upstream transport failures return `503`. - A title with no current offers can still return `200` when metadata is present. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "tm92641", "object_id": 92641, "object_type": "MOVIE", "title": "Inception", "year": 2010, "path": "/us/movie/inception", "url": "https://www.justwatch.com/us/movie/inception", "genres": ["Science-Fiction", "Mystery & Thriller"], "offers": [ { "provider": "Plex", "monetization_type": "RENT", "presentation_type": "HD", "price": 2.99, "currency": "USD", "url": "https://watch.plex.tv/movie/inception" } ] } } ```
MCP tool justwatch_title
/justwatch/title/by-idLooks up a movie or show by raw JustWatch GraphQL id such as `tm92641` or `ts287292`.
Response notes
- Invalid `id`, `country`, or `language` values return `400`. - A valid id with `node: null` returns `404`. - GraphQL errors, challenge payloads, malformed JSON, or incomplete title payloads return `503`. - Offers include normalized provider names, monetization type, presentation type, URL, price, and currency when upstream provides them.
MCP tool justwatch_title_by_id
Related APIs
Media & Streaming
Turn Apple Books ebook and audiobook pages into structured data — search, catalog detail, paginated customer reviews, similar titles, author bibliographies, series listings, and chart rankings as normalized JSON. Credential-free.
Media & Streaming
Search public Ticketmaster events and browse the full discovery hierarchy by category or city, with pagination plus event, attraction, and venue detail endpoints -- including fan reviews, related attractions, trending attractions, and enhanced venue branding -- for live-entertainment research.
Media & Streaming
Search TicketWeb's public event catalog by artist, event, or venue, then resolve any event or venue into normalized detail records with dates, delivery methods, and per-tier ticket pricing.
How to scrape JustWatch
JustWatch 跟踪哪部片名在哪个国家由哪个流媒体平台提供，且没有为此提供公开 API。Crawlora 的 21 个 JustWatch 端点以规范化 JSON 返回搜索、发现、片名、片源、供应商、季和集数据，几乎每次调用都带有国家和语言参数。
按查询词搜索片名、获取热门或新上线的片名，或使用 discover 按类型、供应商、制作国家、变现方式和年份范围进行筛选。
片名详情端点接受 JustWatch 路径或 url；按 ID 查询的变体接受原始 id。无论哪种方式，最终都会得到其余端点所需要的 id。
片名片源端点返回某部片名在何处以何种方式可观看——FLATRATE、FREE、ADS、RENT 或 BUY——并支持在一次调用中传入多个国家。
剧集季列表、季集列表、单集详情和单集片源端点，可以逐层深入某部剧集直到具体每一集的可用性；片名分析端点则直接汇总某部片名的可用性情况。
FAQ
JustWatch 向合作伙伴销售商业数据产品，但没有为第三方开发者提供公开 API。Crawlora 与 JustWatch 没有关联；其端点读取的是无需凭证的公开网站 GraphQL 接口，并将其返回为文档化的 JSON。
先将片名解析为 id，再调用片源端点。它接受以逗号分隔的国家列表，因此一次调用即可回答某部片名在多个市场是否可流媒体观看，每个片源都带有其变现方式——FLATRATE、FREE、ADS、RENT 或 BUY。
两位字母代码：国家如 US 或 DE，语言如 en 或 de。它们决定了你看到的目录以及元数据返回的语言。
可以。供应商片名端点接受一个供应商并返回其在某个国家的目录，供应商列表端点则列出该国家究竟有哪些供应商。