JAVメタデータAPI: 5つのスクレイパーの代わりにエンドポイント1つ

JAVメタデータをアプリに入れたいなら、誰もが歩む道はこうです。ソースを見つけ、スクレイパーを書き、スクレイパーが壊れ、抜けを埋めるために2つ目のソース用にもうひとつ書き、半年後にはタイトルと発売日とカバー画像を手に入れるためだけに、5つの脆い統合を保守しているのです。

公開された安定したJAVメタデータAPIは、世の中に存在しません。最初からありませんでした。javinfo はそのひとつです。それが、これが存在する理由のすべてです。

なぜ「JAVメタデータAPI」はこれほど見つけにくいのか

データは本物で、よく構造化されています。問題はアクセスです。あなたが手を伸ばすであろうあらゆるソースは、契約を備えたAPIではなく、防御を備えたウェブサイトなのです。

DMM / FANZA はカタログの大半を握っており、地球のほとんどをジオブロックしています。アフィリエイトAPIはありますが、ドキュメントは日本語のみで、同じブロックの裏側にあります。
JavDB には公式APIがまったくなく、その名を借りたコミュニティ製スクレイパーがあるだけで、そのほとんどは Cloudflare を突破するために FlareSolverr を必要とします。
JavBus、JavLibrary、R18 も同じ話です。セルフホスト型スクレイパーとDockerコンテナ、予告なく変わるHTMLに縛られたパーサー。

つまり、GitHubで見つかる「API」は常にスクレイパーであり、スクレイパーはソースサイトが抱えるあらゆる問題を受け継ぎます。クラス名のリネームが、変更履歴も警告もなくパーサーを壊します。Cloudflare のチャレンジとリージョンブロックのせいで、ヘッドレスブラウザのバイパスとプロキシも運用することになります。そして各ソースが異なる形を返すので、抜けを埋めるには3つや4つのスキーマを自分で正規化する必要があります。

あなたが保守するのはひとつの統合ではありません。スクレイパーと、バイパスと、プロキシと、深夜2時のためのポケベルを保守することになるのです。

javinfo が代わりにすること

エンドポイントはひとつ。コードを送れば、正規化された結果がひとつ返り、どのソースが応答しても同じフィールドの形になります。

curl -X POST 'https://javinfo-search.p.rapidapi.com/search' \
  -H 'Content-Type: application/json' \
  -H 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  -H 'X-RapidAPI-Host: javinfo-search.p.rapidapi.com' \
  -d '{ "q": "SSIS-001" }'

{
  "result": {
    "q": "SSIS-001",
    "source": "r18",
    "video": {
      "dvdId": "SSIS-001",
      "titleEn": "Newcomer NO.1 STYLE ...",
      "releaseDate": "2020-07-07",
      "runtimeMins": 120,
      "makers": ["S1 NO.1 STYLE"],
      "actresses": [{ "name": "Example Actress", "image": "https://pics.dmm.co.jp/..." }]
    }
  },
  "latencyMs": 142,
  "cached": false
}

すべてのプロバイダーは同じベースの video 形にマッピングされます。dvdId、titleEn/titleJa、releaseDate、runtimeMins、makers、label、series、actresses、jacketFullUrl などです。ソースをまたいで result.video.* を同じように読めます。スクレイピングも、Cloudflare との戦いも、ジオブロックの回避策も私たちが引き受けるので、あなたはやらずに済みます。これが、全体が築かれているプロバイダー非依存の設計です。

プロバイダー

javinfo に最初のマッチを選ばせるか、providers でソースを固定してください。

r18 はバイリンガルのメタデータ(タイトル、出演者、メーカー、レーベル、シリーズ、カバー)に加えて、女優のプロフィール画像とサンプル/ギャラリーのURLを返します。すべてのティアで利用できます。
javdb は、マグネットリンクとダウンロードリンクからなる extra.downloadLinks 配列を追加します。スクレイパーが奪い合っているものです。Pro。
missav は、HLSプレイリストのURL(.m3u8)と解像度別のバリアントからなる extra.streams オブジェクトを追加します。Pro。
javlibrary、javdatabase は近日対応予定です。

ミスした場合、またはすべてのアップストリームがタイムアウトした場合は 504 が返ります。これはたいてい、そのコードがインデックスされていないというだけの意味です。レスポンスはサーバー側でキャッシュされるので、繰り返しの照会は高速です。

はじめる

認証、レート制限、プランは RapidAPI にあります。無料ティアでは r18 のメタデータを1日100リクエストまで利用でき、Pro では javdb と missav のプロバイダー、そのダウンロードリンクとストリームリンク、そして1日1,000リクエストが追加されます。Dockerも、FlareSolverr も、日本のVPNも、更新するクッキーも不要です。1分で動かせます。