按片名搜索电影与电视剧候选项
查看 影视观看平台与流媒体片库查询 的全部接口 →填写必填的 title 片名和 country 小写国家代码，查找候选电影与剧集。show_type 可限制为 movie 或 series，留空则同时搜索两类作品。响应数据直接是影视对象数组，没有 shows 外层字段，也不使用游标分页。候选项可包含影视 ID、IMDb 与 TMDB 标识、片名、原名、年份、简介、分类、导演、演员、评分、片长、图片和按国家归类的 streamingOptions。匹配依据是片名与作品类型，不是当地能否观看，因此候选作品可能在请求地区没有观看选项。请先通过年份、演员和标识确认作品，再检查对应国家的观看入口。通常最多返回 20 项，但完全同名的匹配超过 20 项时可返回全部完全匹配项，不能据此当作完整片库导出。series_granularity 默认 show；season 包含季，episode 包含季与集，仅影响剧集。需要保持条件连续翻页浏览片库时，应改用按筛选条件搜索接口。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/streaming-availability/search-shows-by-title API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/search-shows-by-title?key=<API_KEY>&country=<country>&title=<title>&output_language=en&series_granularity=show'
查询结果
使用场景
- 制作观影清单的选片器，让用户确认上映年份后再保存准确的 IMDb 或 TMDB 标识。
- 为影评站添加搜索框，在访客当地暂无观看入口时仍展示匹配作品的基本资料。
- 将导入清单中的自由文本片名转为候选记录，对歧义名称交给人工选择而非自动猜测。
- 在电影专属或剧集专属搜索表单中先按作品类型收窄结果，再打开选中条目的详情页。
常见问题
不知道 IMDb 或 TMDB ID，只有电影名字还能查询吗？
可以。填写 title 和支持的 country，按需用 show_type 限制电影或剧集。返回候选项后应结合年份、演员及外部标识确认作品，再使用其标识进行详情查询。
为什么能搜到电影，但当前地区没有观看链接？
片名搜索匹配的是作品身份，不保证该作品在请求地区可看。请单独检查 streamingOptions 中对应国家的选项；为空或缺失时可显示当地暂无已报告入口，而不是编造平台或认定作品不存在。
片名搜索返回 20 条后，怎样查询下一页？
此接口没有游标分页，通常返回最多 20 个候选，完全同名匹配超过此数量时另有例外。需要按地区和平台连续浏览多页时，使用片库筛选搜索，并按 hasMore 与 nextCursor 续页。
同名电影和同名电视剧应该如何区分？
可先用 show_type 选择 movie 或 series，再对照 releaseYear、cast、imdbId、tmdbId 等字段。不要只凭显示片名选择第一项；确认后保存类型与标识，后续查询就不必重复猜测。