Dokumentasi API

Integrasikan pencarian screenshot anime ke aplikasi Anda dengan API publik kami.

Kuota Gratis

Signed-in users: 10 free credits per day (expire at midnight). After that, 1 credit per search. Upgrade for more.

Catatan Autentikasi

Endpoint berbasis sesi memerlukan cookie sesi better-auth yang valid. Saat memanggil dari sisi server atau klien non-browser, sertakan header Origin (contoh: Origin: https://your-domain.com) dan simpan cookie yang dikembalikan oleh /api/auth/sign-in/email.

POST/api/anime/search

Cari adegan anime dengan mengunggah file gambar atau menyediakan URL gambar. Mengembalikan hingga 5 kecocokan dengan stempel waktu dan skor kemiripan.

Autentikasi: Session atau API key

Parameter

Nama	Tipe	Wajib	Deskripsi
image	File	Tidak	File gambar (JPEG/PNG)
url	string	Tidak	URL gambar publik

Guests: 5/day by IP. Signed-in users: 10 daily free credits, then 1 credit per search, 100/hour.

Example

curl -X POST https://whatanimeisthis.com/api/anime/search \
  -F "url=https://example.com/screenshot.png"

curl -X POST https://whatanimeisthis.com/api/anime/search \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "url=https://example.com/screenshot.png"

GET/api/anime/rankings

Ambil peringkat anime yang paling banyak dicari berdasarkan periode.

Autentikasi: Tidak ada

Parameter

Nama	Tipe	Wajib	Deskripsi
period	string	Tidak	daily \| weekly \| monthly \| yearly \| all (default: all)
limit	number	Tidak	Hasil maks (default: 50)
includeAdult	boolean	Tidak	Sertakan entri NSFW (default: false)

Tidak memerlukan autentikasi.

Example

curl "https://whatanimeisthis.com/api/anime/rankings?period=daily&limit=10"

GET/api/anime/recent-searches

Ambil pencarian publik yang baru-baru ini dikonfirmasi.

Autentikasi: Tidak ada

Parameter

Nama	Tipe	Wajib	Deskripsi
limit	number	Tidak	Hasil maks
offset	number	Tidak	Offset pagination

Endpoint publik.

Example

curl "https://whatanimeisthis.com/api/anime/recent-searches?limit=5"

GET/api/user/anime-credits

Dapatkan sisa kredit pencarian anime pengguna yang masuk.

Autentikasi: Session

Hanya pengguna masuk.

Example

curl "https://whatanimeisthis.com/api/user/anime-credits" \
  -H "Cookie: <SESSION_COOKIE>"

GET/api/apikeys

Daftar API key Anda.

Autentikasi: Session

Parameter

Nama	Tipe	Wajib	Deskripsi
page	number	Tidak	Nomor halaman
pageSize	number	Tidak	Item per halaman

Hanya pengguna masuk.

Example

curl "https://whatanimeisthis.com/api/apikeys" \
  -H "Cookie: <SESSION_COOKIE>"

POST/api/apikeys

Buat API key baru. Kunci plaintext hanya dikembalikan sekali.

Autentikasi: Session

Parameter

Nama	Tipe	Wajib	Deskripsi
title	string	Ya	Nama deskriptif untuk key

Hanya pengguna masuk.

Example

curl -X POST https://whatanimeisthis.com/api/apikeys \
  -H "Content-Type: application/json" \
  -H "Cookie: <SESSION_COOKIE>" \
  -d '{"title":"my-key"}'