概览
把一部电影或剧集在某个市场的可看情况摊成一张表:哪些平台能看、是订阅包含还是要单独付钱、租和买各是多少、有没有实体碟。做发行比价、内容采购,或者只是想确认「这部片在当地到底在哪看」时,不用再一个个平台翻。
同一部片在不同市场的渠道和价格差别很大,而同一个市场里它又常被拆成十几个平台、几十条报价。这里把「一个平台 × 一种付费方式」合成一行,画质并进去、价格取其中最低的一档,拿到手就是可以直接横向比价的表。
数据说明
数据来自公开的影视上线信息数据库,覆盖北美、欧洲、亚太等主要市场,中国大陆不在其中。
一行代表一个平台的一种付费方式,不是一部片;同一部片会占多行。「最高画质」是这一行并入的最好一档,而「价格」是同一付费方式里最便宜的报价,所以价格对应的画质可能与「最高画质」不同。「订阅」和「影院票」通常没有单片价格,对应的三列留空,不要把空值当成免费。
价格是当地货币的原价,不含税费与手续费,币种见「币种」;「价格原文」保留当地写法,方便人工核对。同一个片名有多个同名版本时只输出最匹配的那一部,结果里的「发行年份」就是判断依据;想指定版本,在片名后加年份。
结果长什么样
每行是某个平台在某个市场的一种看片方式。
| 片名 | 平台 | 付费方式 | 最高画质 | 价格 | 币种 |
|---|---|---|---|---|---|
| Dune | Apple TV Store | 租借 | 4K | 5.99 | USD |
| The Godfather | Fandango At Home | 购买 | 4K | 16.99 | USD |
| Oppenheimer | Apple TV Store | 租借 | 4K | 3.49 | GBP |
此外还有国家或地区、介质类型、平台链接、详情页链接、IMDb 编号等字段。
应用场景
- 发行比价:把同一部片在多个市场的「付费方式」和「价格」并排看,同一档画质下哪个市场租得最贵、哪个市场只有订阅没有单片,一眼就能看出来。
- 渠道盘点:按「平台」汇总,看一部片散落在多少个平台上;只留下「付费方式」为订阅的行,就知道开哪个会员能覆盖大部分内容。
- 价格变动跟踪:隔一段时间用同样的片名重跑,按「报价编号」对齐两次结果,比较「价格」的变化,判断是促销还是调价。
适用边界
覆盖 23 个国家或地区的公开在售报价(不含中国大陆),单次最多 50 个片名、10 个市场、5 万行报价
- 适合用于
- 要确认一部电影或剧集在某个国家有哪些平台能看、是订阅包含还是要单独付租买费用
- 做影视发行或版权比价,需要同一部片在多个市场、多个平台的价格放在一张表里对比
- 不要用于
- 要查中国大陆的平台在哪些地方能看:数据源不覆盖大陆市场
- 要查分集上线时间、分季明细或剧集集数:这里只到片级别的可看渠道
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1某个片名没有返回数据时,先确认名字写法,可加年份括号区分同名作品,或换成当地语言的原名再试
- 2国家或地区代码填错会直接报错并在日志里列出可用代码,改正后重跑即可
- 3网络临时不通导致失败时,隔几分钟原样重跑即可
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 片名
titles必填array<string>要查的电影或剧集名称,中英文都可以写,例如 沙丘 或 Dune。同名作品可以在名字后面用括号加发行年份区分,例如 Dune (1984)。一次最多 50 个,填得越多耗时越长。数量最多 50 项示例["Dune (2021)"] - 国家或地区
countries选填array<string>要查哪些市场的可看渠道,填两位国家或地区代码,默认美国(US)。一次可以填多个市场,每个市场单独出一套报价;最多 10 个,中国大陆(CN)不在覆盖范围内。数量最多 10 项默认值US - 最多写回多少行
maxResults选填integer整次运行最多写回多少行报价,默认 50。一部电影通常 10 到 25 行,达到上限后立刻停止,后面的片名和市场不再查询。范围1–50000默认值50 - 只看这些平台
providers选填array<string>只看指定平台的报价,填平台标识或名称的一部分,例如 netflix、appletv、hbo。留空表示不限平台。数量最多 20 项 - 发行年份
year选填integer片名有多个同名版本时用来锁定年份,例如填 2021 只接受 2021 年那部。填了年份但当地没有该年份的条目时,这个片名不返回数据。范围1888–2100 - 内容类型
contentType选填string(enum)限定只查电影、只查剧集,或两者都查,默认两者都查。可选值电影和剧集all只看电影movie只看剧集show默认值all
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 报价编号
offer_keystring同一部片、同一市场、同一平台、同一付费方式、同一介质类型下恒定不变,可用于跨次运行比对和去重示例tt1160419|US|itunes|RENT|digital - 片名
titlestring该市场使用的片名,香港和台湾市场会返回中文译名示例Dune - 发行年份
release_yearinteger该作品的首次发行年份示例2021 - 内容类型
content_typestring电影或剧集示例电影
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"offer_key": "tt1160419|US|itunes|RENT|digital",
"title": "Dune",
"release_year": 2021,
"content_type": "电影",
"country_code": "US",
"provider_name": "Apple TV Store",
"provider_slug": "itunes",
"monetization_type": "租借",
"offer_category": "数字",
"presentation_type": "4K",
"price": 5.99,
"currency": "USD",
"price_text": "$5.99",
"watch_url": "https://tv.apple.com/us/movie/dune/umc.cmc.2l7qj9p33t3jww1roxi8cgiw5?at=1000l3V2&ct=app_tv&itscg=30200&itsct=justwatch_tv",
"justwatch_url": "https://www.justwatch.com/us/movie/dune-2021",
"imdb_id": "tt1160419",
"scraped_at": "2026-11-17T08:06:28+00:00"
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=bazhuayu_Beth/justwatch-availability",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。