Idola

/idols mencari pemeran, bukan judul. Katalog gabungan javdatabase dan DMM, dibangun ulang tiap minggu: satu kueri menjangkau keduanya.

Jelajahi berdasarkan atribut: kup G, tinggi, tempat lahir. Atau cari satu pemeran lewat id atau slug. Judul: /query. /idols adalah pencarian orang.

Pencarian dan penelusuranSalin tautan

Dua bentuk:

• /idols: cuplikan ringkas. GET atau POST.
• /idols/{id}: satu pemeran dengan rekaman lengkap, lewat id atau slug. Hanya 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"

Daftar tanpa kecocokan adalah 200 biasa dengan count: 0 dan results kosong. Gratis, seperti setiap /query kosong. /idols/{id} pengecualian: meleset = 404.

FilterSalin tautan

Setel satu atau lebih. Tanpa q dan filter: 400.

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

Pengurutan dan paginasiSalin tautan

sort adalah relevance (bawaan), name, age, debut, atau height. debut mengurutkan tanggal lahir, terbaru dulu: paling mendekati, karena katalog tidak bisa mengurutkan langsung berdasarkan tanggal debut.

num 1–50 (bawaan 10), page berbasis 1. Sama seperti /query.

Bentuk item daftarSalin tautan

/idols mengembalikan cuplikan ringkas per kecocokan, pas untuk kartu. Rekaman lengkap: /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://…"
    }
  ]
}

Teruskan id ke /idols/{id}. Nilainya slug javdatabase, atau dmm-<n> untuk pemeran yang hanya diketahui DMM. Kunci internal tidak muncul.

Bentuk satu pemeranSalin tautan

{
  "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 }
  }
}

Setiap field upaya terbaik; nilai tak dikenal tetap null. age dihitung dari dob saat permintaan, jadi tetap terkini setelah pembangunan ulang.

BiayaSalin tautan

$0.50 per 1.000 panggilan pada num=10, bertambah dengan ukuran halaman. Hanya 200 baru yang ditagih; cache dan hasil kosong gratis. Lihat tagihan.

SelanjutnyaSalin tautan

• Referensi API: /idols dan /idols/{id} dengan playground langsung.
• Pemfilteran: tata bahasa filter/sort yang sama pada /query.