Blog

Bởi javinfo team

API Metadata JAV: Một Endpoint Thay Cho Năm Scraper

Mỗi nguồn metadata JAV là một scraper rồi sẽ mục ruỗng. javinfo là một API được host sẵn -- gửi mã DVD, nhận metadata đã chuẩn hóa, không phải canh scraper.

Nếu bạn muốn có metadata JAV trong app của mình, đây là con đường ai cũng gặp. Bạn tìm một nguồn, viết scraper, scraper hỏng, viết thêm một cái nữa cho nguồn thứ hai để lấp khoảng trống, và sáu tháng sau bạn đang bảo trì năm tích hợp mong manh chỉ để lấy một tiêu đề, một ngày phát hành và một ảnh bìa.

Không có API metadata JAV công khai, ổn định nào ngoài kia. Chưa bao giờ có. javinfo là API đó. Đó là toàn bộ lý do nó tồn tại.

Vì sao một “API metadata JAV” lại khó tìm đến thế

Dữ liệu là có thật và được cấu trúc tốt. Vấn đề nằm ở việc truy cập. Mỗi nguồn bạn định nhắm tới đều là một website có lớp phòng thủ, không phải một API có hợp đồng rõ ràng:

Vậy nên cái “API” bạn tìm thấy trên GitHub gần như luôn là scraper, và scraper thừa hưởng mọi vấn đề của trang nguồn. Một lần đổi tên class có thể làm vỡ parser của bạn, không changelog và không cảnh báo. Các thử thách Cloudflare và rào chặn khu vực nghĩa là bạn còn phải chạy thêm bypass trình duyệt headless và proxy. Vì mỗi nguồn trả về một cấu trúc khác nhau, lấp khoảng trống cũng đồng nghĩa với việc tự chuẩn hóa ba bốn schema.

Bạn không bảo trì một tích hợp. Bạn bảo trì scraper, bypass, proxy, và pager cho lúc 2 giờ sáng.

javinfo làm gì thay vào đó

Một endpoint. Gửi mã, nhận một kết quả đã chuẩn hóa, cùng một cấu trúc trường bất kể nguồn nào trả lời.

Look up a code
curl -X POST "https://api.javinfo.dev/movie" \
  -H "x-javinfo-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "q": "SSIS-001" }'
Response
{
  "q": "SSIS-001",
  "source": "r18",
  "result": {
    "dvdId": "SSIS-001",
    "titleEn": "Newcomer 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"
  }
}

Mỗi nhà cung cấp đều ánh xạ vào cùng một cấu trúc result nền tảng: dvdId, titleEn/titleJa, releaseDate, runtimeMins, makers, label, series, actresses, jacketFullUrl, và nhiều hơn nữa. Bạn đọc result.* theo cùng một cách trên mọi nguồn. Chúng tôi lo scraping, Cloudflare và các cách vượt rào chặn khu vực để bạn không phải lo. Đây là thiết kế không bị khóa vào nhà cung cấp mà toàn bộ hệ thống dựa trên. Với các tìm kiếm rộng, endpoint /query trả về một danh sách kết quả khớp thay vì một kết quả tốt nhất.

Các nhà cung cấp

Để javinfo tự chọn kết quả khớp đầu tiên, hoặc ghim một nguồn bằng providers:

Khi không khớp, hoặc nếu mọi upstream đều hết thời gian chờ, bạn nhận về một 404, thường chỉ nghĩa là mã đó chưa được lập chỉ mục. Phản hồi được cache phía server, nên các lượt tra cứu lặp lại rất nhanh.

Bắt đầu

Đăng ký tại app.javinfo.dev, lấy key và truyền qua header x-javinfo-key (cũng có sẵn trên RapidAPI). Mọi nhà cung cấp đều trả về dữ liệu đầy đủ trên từng request, không hề bị chặn theo bậc — tính phí theo mức dùng: /movie giá $0,001 cho mỗi kết quả thành công, /query giá $0,0002, các lượt tra cứu thất bại không bị tính phí. Bạn nạp bằng USDC, cộng theo tỷ lệ 1:1, và các lần nạp từ $50 trở lên nhận thưởng ngẫu nhiên 5–50%; tài khoản mới được tặng 1.000+ lượt tra cứu miễn phí để bắt đầu, không cần thẻ tín dụng. Không Docker, không FlareSolverr, không VPN Nhật, không cookie phải làm mới. Bạn có thể chạy trong một phút.