Penyedia

Sebuah penyedia adalah sumber yang di-scrape dan dinormalisasi oleh javinfo. Setiap pencarian menyebar ke seluruh penyedia terdaftar dan mengembalikan kecocokan terstruktur pertama, sehingga satu panggilan memberi Anda metadata, magnet, dan stream tanpa Anda perlu memelihara scraper yang mudah rusak. Anda dapat membiarkan API memilih (fan-out) atau menyematkan sumber persis yang Anda inginkan.

Daftar Penyedia

fanza dan dmm adalah dua etalase DMM + FANZA. Id kueri mereka adalah query:fanza, query:dmm, query:missav, query:javdb, query:javdatabase.

Memilih Penyedia

Default: fan-out

Hilangkan providers dan setiap penyedia terdaftar menjadi kandidat. API mencobanya secara berurutan dan yang pertama sepenuhnya memenuhi permintaan Anda yang menang:

FANZA → DMM → missav → javdb → javdatabase

Pada /query, penyedia yang tidak dapat memenuhi filter/sort Anda akan dilewati secara diam-diam dan waterfall lanjut ke berikutnya. Pada /movie dan /random tidak ada filter, jadi hanya kecocokan-pertama-yang-menang. Penyedia yang menjawab dipantulkan kembali sebagai source:

{ "q": "SSIS-001", "source": "fanza", "result": { "...": "..." } }

Sematkan dengan providers

Kirim providers untuk memaksa sumber tertentu (atau sekumpulan). Ia menerima array atau daftar dipisah koma, dengan atau tanpa prefiks query::

curl -s -X POST https://api.javinfo.dev/query \
  -H "x-javinfo-key: $KEY" -H 'content-type: application/json' \
  -d '{ "q": "ABP", "providers": ["javdb"], "sort": "rating" }'

"providers": "javdb", ["fanza","missav"], dan "query:javdb" semuanya valid. Ketika penyedia yang disematkan tidak dapat memenuhi permintaan pada /query, ia tidak dilewati — panggilan gagal dengan 422 dan sebuah message yang menyebutkan alasannya (id yang tidak dikenal adalah 400). Lihat Error.

Pemilihan penyedia mendorong tiga permukaan:

• /query — penyematan, waterfall, dan kemampuan per-filter. Penyedia mana yang mendukung filter/sort mana adalah inti dari sistem; lihat matriks kemampuan lengkap.
• /movie / /random — tanpa filter; pemenangnya dipantulkan sebagai source.
• Server MCP — alat javinfo-search / javinfo-movie mengambil argumen providers sendiri (catat javdb di sana hanya untuk film).

Penyedia

fanza / dmm

Etalase DMM + FANZA, dan sumber terstruktur terkaya: semua dimensi bernama (genre, actress, maker, series, director, label, actor), digabungkan bebas, dengan nilai genre/nama bahasa Inggris, filter durasi berbasis menit, sort: release, dan paginasi. Hanya katalog tersensor — filter uncensored mengecualikannya.

missav

Permukaan filter terluas dan sumber stream (URL .m3u8). Setiap dimensi bernama (genre berbahasa Jepang, mis. 巨乳), rentang durasi dan rilis, serta censored dua arah. Kompromi: tanpa sort (hanya relevansi) dan tanpa paginasi sungguhan (selalu halaman 1).

javdb

Tanpa filter per-field, tetapi pengurutan terbaik dan sumber unduhan. Hanya tab censored yang kasar (dua arah), availability (playable / magnets / subtitle / single), dan sort yang kaya (relevance / release / update / rating). Berpaginasi. Sematkan untuk magnet dan tautan unduhan.

javdatabase

Penjelajahan arsip berdasarkan satu dimensi — genre, actress, maker, series, director — di mana hanya genre + maker yang dapat digabungkan (arsip genre ∩ studio). Nilai bahasa Inggris, otomatis di-slug ("S1 NO.1 STYLE" → s1-no-1-style). Tersensor dan tanpa sensor. Berpaginasi, terbaru dulu. Bagus untuk deskripsi dan gambar sampel.

Selanjutnya

• Pemfilteran — matriks kemampuan per-penyedia lengkap dan contekan /query.
• Server MCP — penyedia sebagai argumen alat.
• Referensi API — setiap endpoint dengan playground langsung.