Tìm một FANZA API hay một DMM API bằng tiếng Anh, bạn sẽ về tay không. Catalog thì lớn nhất trong ngành, nhưng cửa chính bị khóa với ai ở ngoài Nhật, và mọi giấy tờ đều bằng tiếng Nhật. Bài này điểm qua thứ thực sự tồn tại, vì sao chẳng cái nào chạy được bằng tiếng Anh, và cách lấy lại chính metadata đó dưới dạng JSON đã chuẩn hóa.
FANZA hay DMM có API tiếng Anh không?
Không. Có một API affiliate tại affiliate.dmm.com/api, và FANZA (nhánh nội dung người lớn của DMM) chạy trên chính cái đó. Hai vấn đề khiến nó vô dụng nếu bạn không ở Nhật:
- Bị chặn theo khu vực. dmm.co.jp chặn theo khu vực gần như cả hành tinh, và API affiliate nằm sau chính bức tường đó. Bạn cần một IP Nhật chỉ để đọc tài liệu của cái API vốn được dựng ra để đẩy traffic về cho bạn.
- Tài liệu chỉ có tiếng Nhật. Không hề có bản tham chiếu tiếng Anh nào. Còn schema phản hồi thì là bất cứ thứ gì backend của DMM trông như hồi 2014 – hàng chục trường, không changelog, không báo trước khi một trường biến mất.
Vậy nên “FANZA API bằng tiếng Anh” không phải thứ bạn cấu hình. Đó là một dự án scrape-và-dịch mà bạn phải tự dựng rồi ngồi canh.
Lấy metadata DMM/FANZA bằng tiếng Anh
javinfo lo cái vụ vượt rào chặn khu vực và chuẩn hóa một lần, phía server, rồi trao cho bạn một kết quả sạch sẽ. Gửi một mã DVD tới POST /movie và để nhà cung cấp fanza trả lời:
curl -X POST "https://api.javinfo.dev/movie" \ -H "x-javinfo-key: YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "q": "SSIS-001", "providers": "fanza" }'{ "q": "SSIS-001", "source": "fanza", "result": { "dvdId": "SSIS-001", "titleEn": "Newcomer NO.1 STYLE ...", "titleJa": "新人 NO.1 STYLE ...", "releaseDate": "2020-07-07", "runtimeMins": 120, "makers": ["S1 NO.1 STYLE"], "actresses": ["Example Actress"], "jacketFullUrl": "https://pics.dmm.co.jp/digital/video/ssis00001/ssis00001pl.jpg" }}Bạn nhận được cả titleEn lẫn titleJa, nên tiếng Anh là một trường để đọc, không phải bước dịch mà bạn phải tự gánh. Nhà cung cấp dmm/fanza trả về metadata song ngữ – tiêu đề, dàn diễn viên, nhà sản xuất, nhãn, series, ảnh bìa – cộng thêm ảnh hồ sơ diễn viên và URL bộ ảnh sample mà phần lớn scraper bỏ qua. Độ phủ đạt khoảng 99% thư viện dmm.co.jp, và hầu hết mã tra được ngay lần đầu.
Cần một danh sách thay vì một kết quả khớp duy nhất? POST /query nhận một tìm kiếm rộng và trả về các kết quả ứng viên trong cùng một cấu trúc.
Một cấu trúc, mọi nguồn
Object result giống hệt nhau bất kể nhà cung cấp nào trả lời, nên cái parser bạn viết cho FANZA cũng đọc được luôn JavDB, MissAV và javdatabase. Đó là thiết kế không phụ thuộc nhà cung cấp mà cả hệ thống dựa trên – một JAV metadata API đã chuẩn hóa, thay cho một tích hợp riêng cho mỗi nguồn.
Đăng ký tại app.javinfo.dev, lấy một key, và truyền nó trong header x-javinfo-key (cũng có trên RapidAPI). Tính phí theo mức dùng: /movie là $0.0005 cho mỗi kết quả thành công, /query là $0.0002, và các lượt tra cứu thất bại không bị tính phí. Tài khoản mới được tặng hơn 1.000 lượt tra cứu miễn phí, không cần thẻ tín dụng; sau đó nạp bằng USDC, cộng theo tỷ lệ 1:1. Không VPN Nhật, không tài liệu tiếng Nhật, không scraper phải bảo trì. Bạn có thể chạy trong một phút.