IMDb 作品検索

映画とテレビ作品を検索する IMDb 検索 API

IMDb を HTTP で検索し、公開年・人気ランク・主要キャストを 1 つのフィールドで取得します。ページを開かずに作品を特定できるだけの情報が揃います。

エンドポイント
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 は、IMDb のレコードを構造化された結果として返す HTTP インターフェースです。IMDb は汎用的な公開検索 API を提供しておらず、商用データ製品はライセンス提供が中心で、数件の照会を行いたい開発者向けではありません。そのため多くの統合はスクレイピングに行き着きます。Search1API は IMDb を Search endpoint の検索サービスの 1 つとして提供し、種別マーカー付きのタイトル、IMDb のリンク、人気ランク・公開年・主要キャストを含むスニペットを、他のエンジンと同じ JSON 形式で返します。この組み合わせこそが作品の特定に必要なものです。同名の 2 作品はタイトルではなく、公開年とキャストで見分けられます。

実装の流れ

典型的な流れ

IMDb を HTTP で検索し、公開年・人気ランク・主要キャストを 1 つのフィールドで取得します。ページを開かずに作品を特定できるだけの情報が揃います。

1

`search_service` に `imdb` を指定してクエリを送信します。

2

`snippet` をパイプで分割して、ランク、公開年、キャストを切り分けます。

3

レコードの要約ではなく作品ページが必要な場合は `crawl_results` を指定します。

1 回のリクエストで特定できる作品情報を取得

1 回の呼び出しで 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
  }'

主な用途

ユーザーが曖昧に挙げた映画やシリーズを特定するアシスタント。

公開年とキャストでエントリを補強するメディアカタログ。

正規の作品レコードが必要なレコメンドフロー。

映画とシリーズをプログラム的に分離するコンテンツツール。

次のリンク

1 つのエンドポイントで 17 の検索エンジン

YouTube 検索 API
Wikipedia 検索 API
Google 検索 API
Search API
API ドキュメントを見る
料金を見る

FAQ

IMDb の公式 API はありますか？

IMDb は汎用的な公開検索 API を提供していません。商用のデータ提供はリクエスト単位の開発者向け API ではなくライセンス製品であるため、多くの統合はサイトのスクレイピングに依存します。Search1API は IMDb を Search endpoint のエンジンの 1 つとして提供し、照会の用途に対応します。

結果にはどのようなメタデータが含まれますか？

`(feature)` などの種別マーカー付きのタイトル、IMDb のリンク、そして「Rank: N | 年 | 主要キャスト」形式のスニペットです。

評価スコアは取得できますか？

検索結果に含まれるのはユーザー評価ではなく人気ランクです。作品ページ上の情報が必要な場合は `crawl_results` を指定してページを取得してください。

IMDb 検索の料金はいくらですか？

検索 1 回あたり 1 クレジット、`crawl_results` で取得に成功したページごとに 1 クレジットが加算されます。チャージの基本レート（$1 = 1,000 クレジット）では 1,000 回の検索が $1 です。登録時にクレジットカードなしで 100 クレジットが付与されます。

映画とシリーズを区別できますか？

区別できます。タイトル内の種別マーカーで判別できるため、追加リクエストなしでフィルタできます。

他の参照系ソースにも対応していますか？

同じ Search endpoint が参照記事の `wikipedia`、動画の `youtube` に対応します。一般 Web エンジンや中国語エンジンと合わせ、1 つの契約で計 17 エンジンを利用できます。