Idol

/idols tìm diễn viên, không phải tựa đề. Danh mục hợp nhất từ javdatabase và DMM, xây dựng lại hàng tuần: một truy vấn chạm tới cả hai nguồn.

Duyệt theo thuộc tính: cỡ G, chiều cao, nơi sinh. Hoặc tra cứu một diễn viên theo id hay slug. Tựa đề: /query. /idols là tìm kiếm về con người.

Tìm kiếm và tra cứuSao chép liên kết

Hai dạng:

• /idols: teaser gọn. GET hoặc POST.
• /idols/{id}: một diễn viên với hồ sơ đầy đủ, theo id hoặc slug. Chỉ GET.

# A list of matches
curl -s -X POST https://api.javinfo.dev/idols \
  -H "x-javinfo-key: $KEY" -H 'content-type: application/json' \
  -d '{ "q": "yui", "num": 20 }'

# One performer
curl -s https://api.javinfo.dev/idols/dmm-1005467 \
  -H "x-javinfo-key: $KEY"

Danh sách không khớp là 200 bình thường với count: 0 và results rỗng. Miễn phí, như mọi /query rỗng. /idols/{id} là ngoại lệ: trượt là 404.

Bộ lọcSao chép liên kết

Đặt một hoặc nhiều. Không q và không bộ lọc: 400.

# Every G-cup performer, tallest first
-d '{ "filter": { "cup": "G" }, "sort": "height" }'

Sắp xếp và phân trangSao chép liên kết

sort là relevance (mặc định), name, age, debut hay height. debut sắp theo ngày sinh, mới nhất trước: mức gần nhất có thể, vì danh mục không sắp trực tiếp theo ngày ra mắt.

num là 1–50 (mặc định 10), page bắt đầu từ 1. Như trên /query.

Một mục danh sách trông như thế nàoSao chép liên kết

/idols trả về teaser gọn cho mỗi kết quả khớp, vừa đủ để vẽ thẻ. Hồ sơ đầy đủ: /idols/{id}.

{
  "q": "yui",
  "source": "idols",
  "count": 10,
  "total": 42,          // estimated matches across all pages (may be capped)
  "results": [
    {
      "id": "dmm-1005467",
      "name": "…",
      "nameJa": "…",
      "image": "https://…",
      "tags": ["…"],
      "pageUrl": "https://…"
    }
  ]
}

Truyền id cho /idols/{id}. Đó là slug javdatabase, hoặc dmm-<n> cho diễn viên chỉ DMM biết. Khóa nội bộ không xuất hiện.

Một diễn viên trông như thế nàoSao chép liên kết

{
  "q": "dmm-1005467",
  "source": "idols",
  "result": {
    "id": "dmm-1005467",
    "name": "…",
    "nameJa": "…",
    "image": "https://…",
    "tags": ["…"],
    "pageUrl": "https://…",
    "slug": "…",
    "age": 37,
    "dob": "1990-01-01",
    "debut": "…",
    "debutAge": 20,
    "birthplace": "…",
    "sign": "…",
    "blood": "…",
    "measurements": "…",
    "cup": "…",
    "heightCm": 165,
    "shoeSize": 24.5,
    "hairLengths": ["…"],
    "hairColors": ["…"],
    "aliases": ["…"],
    "images": ["https://…"],
    "sources": ["javdatabase", "dmm"],
    "ids": { "javdatabase": "…", "dmm": 1005467 }
  }
}

Mọi trường ở mức nỗ lực tối đa; giá trị không rõ vẫn là null. age tính từ dob lúc có yêu cầu, nên luôn cập nhật sau mỗi lần xây dựng lại.

Chi phíSao chép liên kết

$0.50 cho mỗi 1.000 lần gọi ở num=10, tăng theo kích thước trang. Chỉ 200 mới bị tính phí; cache và kết quả rỗng miễn phí. Xem thanh toán.

Tiếp theoSao chép liên kết

• Tài liệu tham khảo API: /idols và /idols/{id} kèm playground trực tiếp.
• Lọc: cùng ngữ pháp lọc/sắp xếp trên /query.