API Docs

Dokumentasi resmi untuk Chioriya Screenshot API. Endpoint ini mengambil screenshot website dan mengembalikan gambar langsung tanpa bungkus JSON saat sukses.

Domain API: ssweb.chioriya.my.id Panel: bot.chioriya.my.id Format: WebP / JPEG / PNG

Domain aktif

Dashboard SSWebhttps://ssweb.chioriya.my.id

Panel Bothttps://bot.chioriya.my.id

Endpoint utamaGET /api/screenshot

Quick Start

GET https://ssweb.chioriya.my.id/api/screenshot?url=https%3A%2F%2Fapi.chioriya.my.id

Response sukses berupa file gambar langsung: image/webp, image/jpeg, atau image/png. Karena bukan JSON, endpoint ini bisa langsung dipakai di <img>, fetch arraybuffer, atau buffer bot WhatsApp.

Contoh cepat

https://ssweb.chioriya.my.id/api/screenshot?url=https%3A%2F%2Fs.chioriya.my.id&format=webp&quality=80&width=1280&height=720&delay=1000&waitUntil=domcontentloaded

Connector & Apikey

Informasi cara tautin akun dan Manage Apikey sekarang dipindahkan ke halaman Dashboard utama agar lebih mudah untuk pengguna public.

Tanpa API key, request guest memakai cooldown IP. Dengan akun panel/API key, request memakai limit akun panel dan tidak terkena cooldown IP guest.

Endpoint Screenshot

GET https://ssweb.chioriya.my.id/api/screenshot

Param	Default	Keterangan
`url`	wajib	URL target. Harus `http://` atau `https://`.
`format` / `type`	`webp`	`webp`, `jpeg`, `jpg`, atau `png`.
`quality`	`80`/`82`	Kualitas 10–100 untuk WebP/JPEG. Tidak berpengaruh untuk PNG.
`width` / `w`	`1280`	Lebar viewport. Range aman: 320–2400.
`height` / `h`	`720`	Tinggi viewport. Range aman: 240–2400.
`dpr` / `scale`	`1`	Device pixel ratio. Range 1–3. DPR tinggi membuat file lebih besar.
`fullPage` / `full`	`0`	`1` untuk screenshot seluruh halaman. Hindari pada halaman sangat panjang.
`mobile`	`0`	`1` untuk mode mobile/touch viewport.
`dark`	`0`	`1` untuk preferensi dark mode.
`transparent` / `omitBackground`	`0`	`1` untuk background transparan jika format mendukung.
`selector`	kosong	Screenshot elemen tertentu berdasarkan CSS selector.
`waitUntil`	`networkidle2`	`load`, `domcontentloaded`, `networkidle0`, atau `networkidle2`.
`delay` / `wait`	`500`	Delay tambahan 0–5000 ms setelah halaman dimuat.
`timeout`	`45000`	Timeout render 5000–55000 ms.
`failOnStatus`	`0`	Jika `1`, request gagal saat target memberi HTTP error.
`debug`	`0`	Jika `1`, error dikembalikan sebagai JSON detail.
`apikey` / `apiKey`	opsional	API key dari panel bot. Jika diisi, request mengurangi limit panel dan tidak terkena cooldown IP.

Response Headers

`Content-Type`	Tipe gambar hasil screenshot.
`X-Screenshot-Format`	Format akhir yang dipakai API.
`X-Screenshot-Trace`	ID trace untuk pelacakan error oleh admin layanan.
`X-Chioriya-Auth`	`panel` jika request memakai sesi tertaut/API key panel, atau `panel-denied` jika auth panel ditolak.
`X-Chioriya-Usage`	ID penggunaan panel. Dipakai sistem untuk refund jika render gagal.
`X-Chioriya-Remaining`	Sisa limit panel setelah request, jika panel mengirim data tersebut.
`X-RateLimit-Limit`	Batas request guest per window.
`X-RateLimit-Remaining`	Sisa request guest di window aktif.
`X-RateLimit-Reset`	Unix timestamp saat window guest reset.
`Retry-After`	Muncul saat status `429`.

Preset Disarankan

Balanced

format=webp&quality=80&width=1280&height=720&dpr=1

Hemat size / bot

format=jpeg&quality=76&width=1280&height=720&waitUntil=domcontentloaded&delay=800

Kualitas tinggi

format=png&width=1440&height=900&dpr=2

Untuk serverless, hindari fullPage=1 + dpr=2/3 pada halaman panjang karena ukuran response bisa terlalu besar.

Contoh Error

Saat gagal, mode biasa menampilkan plain text. Untuk melihat detail, tambahkan debug=1.

https://ssweb.chioriya.my.id/api/screenshot?url=https%3A%2F%2Fapi.chioriya.my.id&debug=1

Gunakan nilai X-Screenshot-Trace jika perlu melaporkan error ke admin layanan.

Catatan Target Website

Target dengan CAPTCHA, login wajib, Cloudflare challenge, atau bot protection bisa kosong/gagal.
URL internal/private network diblokir demi keamanan.
Gunakan waitUntil=domcontentloaded dan delay=800 untuk website berat.
Untuk elemen spesifik, pakai selector=.nama-class.

Contoh Penggunaan

HTML

<img src="https://ssweb.chioriya.my.id/api/screenshot?url=https%3A%2F%2Fapi.chioriya.my.id&format=webp&quality=80" alt="preview" />

Node.js CommonJS + axios

const axios = require("axios");

async function getScreenshotBuffer(url, apiKey) {
  const res = await axios.get("https://ssweb.chioriya.my.id/api/screenshot", {
    responseType: "arraybuffer",
    headers: apiKey ? { "x-api-key": apiKey } : {},
    params: {
      url,
      format: "jpeg",
      quality: 76,
      width: 1280,
      height: 720,
      waitUntil: "domcontentloaded",
      delay: 800
    }
  });

  return Buffer.from(res.data);
}

curl

curl -L "https://ssweb.chioriya.my.id/api/screenshot?url=https%3A%2F%2Fapi.chioriya.my.id&format=webp&quality=80" --output screenshot.webp

curl dengan API key

curl -L "https://ssweb.chioriya.my.id/api/screenshot?url=https%3A%2F%2Fapi.chioriya.my.id" \
  -H "Authorization: Bearer API_KEY_PANEL" \
  --output screenshot.webp

Pixiv API juga tersedia

Dashboard utama sekarang punya sidebar untuk berpindah antara SSWeb API dan Pixiv API. Dokumentasi Pixiv ada di pixiv-docs.html.