Pixiv Search & Download API

Endpoint tambahan untuk mencari ilustrasi Pixiv, mengambil detail karya, dan membuka gambar sebagai direct image bytes. Cocok untuk preview website, bot, dan integrasi backend.

Aturan public:
Guest search maksimal 5 hasil dan cooldown 30 detik per IP. Endpoint gambar bisa dibuka langsung tanpa API key.

SearchCari illust/manga/ugoira berdasarkan tag, keyword, title, atau caption.

DetailAmbil metadata karya, tags, page count, dan URL proxy tiap halaman.

DownloadResponse sukses langsung image bytes, cocok untuk buffer bot WhatsApp.

Auth & Rate Limit

Mode	Aturan
Guest search/detail	Cooldown 30 detik per IP. Search guest maksimal 5 hasil per request.
Akun tertaut panel	Tanpa cooldown IP. Request memakai cookie connector panel dan memotong limit akun.
API key panel	Pakai query `apikey`, header `x-api-key`, atau `Authorization: Bearer`.
Download image	Bisa dibuka langsung tanpa API key dan tanpa cooldown IP.

Ringkasan Akses

Untuk pengguna public, cukup gunakan endpoint di bawah. API key hanya dibutuhkan jika ingin melewati cooldown guest pada search/detail.

/api/pixiv?action=search&q=Columbina
/api/pixiv?action=detail&id=123456789
/api/pixiv?action=download&id=123456789&page=0&size=large

Gunakan endpoint download untuk preview gambar langsung. Endpoint ini sengaja dibuat bebas API key agar mudah dipasang sebagai URL gambar.

Endpoint Search

GET /api/pixiv?action=search&q=Columbina&limit=5&safe=1

Param	Default	Keterangan
`q` / `query` / `word`	wajib	Keyword atau tag pencarian.
`limit`	`5`	Jumlah hasil dikembalikan. Guest maksimal 5, API key/panel maksimal 30.
`offset`	`0`	Offset hasil Pixiv untuk pagination manual.
`sort`	`date_desc`	`date_desc`, `date_asc`, atau `popular_desc`.
`searchTarget` / `target`	`partial_match_for_tags`	`partial_match_for_tags`, `exact_match_for_tags`, `title_and_caption`, atau `keyword`.
`safe`	`1`	Default memfilter R-18/R-18G. Pakai `includeR18=1` untuk menonaktifkan filter jika akun/aturan kamu mengizinkan.
`apikey`	opsional	API key panel bot agar tidak kena cooldown IP guest.

Endpoint Detail

GET /api/pixiv?action=detail&id=123456789

Param	Keterangan
`id` / `illustId`	ID artwork Pixiv.
`apikey`	API key panel opsional.

Endpoint Download

GET /api/pixiv?action=download&id=123456789&page=0&size=original

Param	Default	Keterangan
`id` / `illustId`	wajib	ID artwork Pixiv.
`page`	`0`	Index halaman gambar. Untuk manga/multi-page, mulai dari 0.
`size`	`original`	`original`, `large`, `medium`, atau `square_medium`.
`apikey`	tidak perlu	Endpoint image bisa langsung dibuka tanpa API key.

Contoh Response Search

{
  "ok": true,
  "source": "pixiv",
  "query": "Columbina",
  "safeOnly": true,
  "count": 6,
  "items": [
    {
      "id": 123456789,
      "title": "Columbina",
      "type": "illust",
      "pageCount": 1,
      "user": { "name": "Artist" },
      "pixivUrl": "https://www.pixiv.net/artworks/123456789",
      "imageUrl": "/api/pixiv?action=download&id=123456789&page=0&size=large",
      "originalUrl": "/api/pixiv?action=download&id=123456789&page=0&size=original"
    }
  ]
}

Node.js CommonJS + axios

const axios = require("axios");

async function pixivSearch(domain, query, apiKey) {
  const res = await axios.get(`${domain}/api/pixiv?action=search`, {
    params: { q: query, limit: 6, safe: 1 },
    headers: apiKey ? { "x-api-key": apiKey } : {}
  });
  return res.data.items;
}

async function pixivDownload(domain, id) {
  const res = await axios.get(`${domain}/api/pixiv?action=download`, {
    responseType: "arraybuffer",
    params: { id, page: 0, size: "original" }
  });
  return Buffer.from(res.data);
}

Baileys / Keila

const items = await pixivSearch("https://ssweb.chioriya.my.id", "hutao", "API_KEY_PANEL");
const top = items[0];
const buffer = await pixivDownload("https://ssweb.chioriya.my.id", top.id);

await keila.sendMessage(m.chat, {
  image: buffer,
  caption: `Pixiv\nTitle: ${top.title}\nAuthor: ${top.user.name}\nURL: ${top.pixivUrl}`
}, { quoted: m });

curl

curl -L "https://ssweb.chioriya.my.id/api/pixiv?action=search&q=Columbina&limit=5&safe=1"

curl -L "https://ssweb.chioriya.my.id/api/pixiv?action=download&id=123456789&page=0&size=original" --output pixiv.jpg

Catatan Penting

Endpoint download melakukan proxy image Pixiv dari server, sehingga browser/bot tidak perlu mengatur header referer Pixiv manual.
Guest search dibatasi agar API publik tetap stabil.
Default search memakai safe filter untuk menyembunyikan R-18/R-18G.
Untuk integrasi bot/server yang sering request, gunakan API key panel agar tidak terkena cooldown IP guest.
Gunakan sesuai aturan Pixiv dan hak cipta artist. Jangan re-upload karya orang tanpa izin.