IMDb 影视搜索

用 IMDb 搜索 API 检索影视作品

通过 HTTP 检索 IMDb,在一个字段里拿到上映年份、热度排名和主演阵容,不打开页面就足以确定是哪一部。

接口
POST https://api.search1api.com/search
IMDb 搜索结果包含什么

结果的 JSON 结构与其他引擎一致,现有的解析逻辑不需要改动。

1
带类型标记的片名

标题里带 (feature) 这样的标记,可区分电影和剧集。

2
排名与上映年份

摘要以热度排名和年份开头。

3
主演阵容

摘要的其余部分是主演列表。

适用于

作品定位 / 影视库补全 / 推荐系统

足够选中正确那一部的元数据

把 `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,在一个字段里拿到上映年份、热度排名和主演阵容,不打开页面就足以确定是哪一部。

1

把 `search_service` 设为 `imdb` 后发送查询。

2

按竖线切分 `snippet`,分离出排名、年份和主演。

3

当流程需要作品详情页而不只是条目摘要时,设置 `crawl_results`。

一次请求,能区分开的作品条目

一次调用即可检索 IMDb,每条结果带上年份和主演,翻拍和原作哪个页面都不用打开就能分清。

bash
curl -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 个引擎。