ブログ

著者 javinfo team

Javdatabase API — サイトを使わずに javdatabase.com のデータを取得

javdatabase.com を検索中ですか?英語の説明文、サンプルギャラリー、予告編 URL を、任意の JAV コードで1つの API から取得。正規化された JSON で、スクレイピング不要です。

javdatabase.com は、リリースについて読むのに適したサイトの1つです。きちんとした英語の説明文、厳選されたサンプルギャラリー、そして時には予告編もあります。しかしそれは閲覧用に作られたサイトであって、呼び出せるデータベースではありません。公開された javdatabase API は存在しません。そのデータをアプリで使いたければ、選択肢はブラウザのタブを開くか、スクレイパーを書くかの2つだけです。javinfo は3つ目の選択肢を提供します。

サイトを介さずに、データだけを

javinfo は javdatabase をプロバイダーとして動かしています。POST /movieproviders: "javdatabase" を指定して呼び出すと、このサイトが得意とするフィールド、つまり完全な英語の description(1行の要約ではありません)、sampleImages、そして存在する場合は trailerUrl が、標準の基本フィールド(タイトル、キャスト、リリース日、カバーアート)に加えて返されます。

作品を検索
curl -X POST "https://api.javinfo.dev/movie" \
-H "x-javinfo-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "q": "SSIS-001", "providers": "javdatabase" }'
レスポンス(javdatabase)
{
"q": "SSIS-001",
"source": "javdatabase",
"result": {
"dvdId": "SSIS-001",
"titleEn": "After Abstaining From Sex...",
"extra": {
"description": "A newlywed wife succumbs to temptation...",
"sampleImages": ["https://www.javdatabase.com/images/samples/ssis-001_1.webp"],
"trailerUrl": "https://www.javdatabase.com/trailers/ssis-001.mp4"
}
}
}

javdatabase.com をスクレイピングしない理由

スクレイパーは統合ではなく、保守の負債だからです。変更履歴もなく変わっていく HTML を解析し、サイトが次に追加するアンチボット対策と戦い、ある朝それが黙ってブランクを返し始めたらパーサーを作り直すことになります。javinfo はその作業をサーバー側で一度だけ行い、代わりに安定した JSON の契約を渡します。マークアップが変わったら私たちが直し、あなたのコードは同じエンドポイントを呼び続けるだけです。

1つの形、すべてのソース

/movie エンドポイントは4つすべてのプロバイダー(dmm/fanza、javdb、missav、javdatabase)と対話し、どれが応答しても1つの正規化された result を返します。ですから javdatabase の説明文とサンプルは、JavDB のマグネットリンクMissAV のストリームとまったく同じ形に収まります。"providers": "javdatabase" を固定するか、デフォルトの順序に試させて、javdatabase が最良の答えを持つときにそれを採用させることもできます。すべてのソースを横断する1つの JAV メタデータ API であり、設計からしてプロバイダー非依存です。同じクエリ可能なデータベースの考え方を、1つのプロバイダーに固定しただけです。

app.javinfo.dev でサインアップしてキーを取得し、x-javinfo-key ヘッダーで渡してください(RapidAPI でも利用できます)。従量課金制です。/movie は成功した結果1件につき $0.00075、/query は $0.00035、失敗した検索は無料です。新規登録で50件の無料検索が付き、クレジットカードは不要です。(2つの役割を1度にこなしていた古い /search エンドポイントは置き換えられています。エンドポイント分割について読む。)1分で動かし始められます。