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

NamaTipeWajibDeskripsi
imageFileTidakFile gambar (JPEG/PNG)
urlstringTidakURL 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

NamaTipeWajibDeskripsi
periodstringTidakdaily | weekly | monthly | yearly | all (default: all)
limitnumberTidakHasil maks (default: 50)
includeAdultbooleanTidakSertakan 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

NamaTipeWajibDeskripsi
limitnumberTidakHasil maks
offsetnumberTidakOffset 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

NamaTipeWajibDeskripsi
pagenumberTidakNomor halaman
pageSizenumberTidakItem 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

NamaTipeWajibDeskripsi
titlestringYaNama 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"}'