用 IMDb 搜索 API 检索影视作品
通过 HTTP 检索 IMDb,在一个字段里拿到上映年份、热度排名和主演阵容,不打开页面就足以确定是哪一部。
接口POST https://api.search1api.com/search
结果的 JSON 结构与其他引擎一致,现有的解析逻辑不需要改动。
标题里带 (feature) 这样的标记,可区分电影和剧集。
摘要以热度排名和年份开头。
摘要的其余部分是主演列表。
适用于
作品定位 / 影视库补全 / 推荐系统
足够选中正确那一部的元数据
把 `search_service` 设为 `imdb`,结果就来自 IMDb 的条目。接口地址、鉴权方式和响应结构与其他引擎完全一致。
摘要里带年份和主演
`snippet` 字段的格式为「Rank: N | 年份 | 主演」,通常足以分清翻拍和原作。
标题里带类型标记
`title` 字段带 `(feature)` 这类标记,不用再发一次请求就能把电影和剧集分开。
带一个可用于排序的热度信号
当同名条目很多时,排名给出了一个可用的先后顺序。
标准 Search 参数
`max_results` 最大 50,以及 `include_sites`、`exclude_sites`、`time_range`。
什么是 IMDb 搜索 API?
IMDb 搜索 API 是一种 HTTP 接口,把 IMDb 的条目以结构化结果返回。IMDb 没有通用的公开搜索 API,其商业数据产品面向的是数据授权,而不是只想做几次查询的开发者,所以多数集成最后都变成了抓站。Search1API 把 IMDb 作为 Search 接口的一个搜索服务提供,返回带类型标记的片名、IMDb 链接,以及带热度排名、上映年份和主演阵容的摘要,JSON 结构与其他引擎一致。这个组合正是"确定是哪一部"真正需要的:两部同名片是靠年份和主演区分的,不是靠片名。
典型流程
通过 HTTP 检索 IMDb,在一个字段里拿到上映年份、热度排名和主演阵容,不打开页面就足以确定是哪一部。
把 `search_service` 设为 `imdb` 后发送查询。
按竖线切分 `snippet`,分离出排名、年份和主演。
当流程需要作品详情页而不只是条目摘要时,设置 `crawl_results`。
一次请求,能区分开的作品条目
一次调用即可检索 IMDb,每条结果带上年份和主演,翻拍和原作哪个页面都不用打开就能分清。
bashcurl -X POST https://api.search1api.com/search \-H "Authorization: Bearer $SEARCH1API_KEY" \-H "Content-Type: application/json" \-d '{"query": "blade runner","search_service": "imdb","max_results": 5}'
适合场景
用户只说了个大概片名,需要定位到具体作品的助手。
用年份和主演补全条目的影视资料库。
需要规范作品条目的推荐流程。
需要程序化区分电影与剧集的内容工具。
常见问题
IMDb 有官方 API 吗?
IMDb 没有通用的公开搜索 API。它的商业数据供给是授权产品,而不是按请求计费的开发者 API,这也是多数集成最后选择抓站的原因。Search1API 把 IMDb 作为 Search 接口的一个引擎提供,用于这类查询场景。
一条结果带哪些元数据?
带 `(feature)` 这类类型标记的片名、IMDb 链接,以及形如「Rank: N | 年份 | 主演」的摘要。
可以拿到评分吗?
搜索结果里带的是热度排名,不是用户评分。当流程需要详情页上渲染的内容时,设置 `crawl_results` 抓取作品页面。
IMDb 搜索的费用是多少?
每次搜索消耗 1 积分,通过 `crawl_results` 每成功抓取一个页面追加 1 积分。按 $1 = 1,000 积分的充值基础价计算,1,000 次搜索为 $1。注册即送 100 个免费积分,无需信用卡。
能区分电影和剧集吗?
能。标题里的类型标记就能区分,不用再发一次请求就可以过滤。
还支持哪些参考类来源?
同一个 Search 接口还支持参考条目的 `wikipedia` 和视频的 `youtube`,加上通用网页引擎和中文引擎,一套契约共 17 个引擎。