เอกสาร API

ผสานรวมการค้นหาภาพหน้าจออนิเมะเข้ากับแอปของคุณผ่าน API สาธารณะ

โควต้าฟรี

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

หมายเหตุการตรวจสอบสิทธิ์

เอนด์พอยต์แบบเซสชันต้องการคุกกี้เซสชัน better-auth ที่ถูกต้อง เมื่อเรียกจากฝั่งเซิร์ฟเวอร์หรือไคลเอนต์ที่ไม่ใช่เบราว์เซอร์ ให้ระบุหัวข้อ Origin (เช่น Origin: https://your-domain.com) และเก็บคุกกี้ที่ได้รับจาก /api/auth/sign-in/email

POST/api/anime/search

ค้นหาฉากอนิเมะโดยอัปโหลดไฟล์รูปภาพหรือระบุ URL รูปภาพ คืนค่าสูงสุด 5 ผลลัพธ์พร้อม timestamp และคะแนนความคล้ายคลึง

การตรวจสอบสิทธิ์: Session หรือ API key

พารามิเตอร์

ชื่อ	ประเภท	จำเป็น	คำอธิบาย
image	File	ไม่	ไฟล์รูปภาพ (JPEG/PNG)
url	string	ไม่	URL รูปภาพสาธารณะ

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

ดึงอันดับอนิเมะที่ถูกค้นหามากที่สุดตามช่วงเวลา

การตรวจสอบสิทธิ์: ไม่มี

พารามิเตอร์

ชื่อ	ประเภท	จำเป็น	คำอธิบาย
period	string	ไม่	daily \| weekly \| monthly \| yearly \| all (ค่าเริ่มต้น: all)
limit	number	ไม่	ผลลัพธ์สูงสุด (ค่าเริ่มต้น: 50)
includeAdult	boolean	ไม่	รวมรายการ NSFW (ค่าเริ่มต้น: false)

ไม่ต้องใช้การตรวจสอบสิทธิ์

Example

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

GET/api/anime/recent-searches

ดึงการค้นหาสาธารณะที่ได้รับการยืนยันล่าสุด

การตรวจสอบสิทธิ์: ไม่มี

พารามิเตอร์

ชื่อ	ประเภท	จำเป็น	คำอธิบาย
limit	number	ไม่	ผลลัพธ์สูงสุด
offset	number	ไม่	offset การแบ่งหน้า

เอนด์พอยต์สาธารณะ

Example

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

GET/api/user/anime-credits

รับเครดิตการค้นหาอนิเมะที่เหลือของผู้ใช้ที่เข้าสู่ระบบปัจจุบัน

การตรวจสอบสิทธิ์: Session

เฉพาะผู้ใช้ที่เข้าสู่ระบบ

Example

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

GET/api/apikeys

แสดงรายการ API key ของคุณ

การตรวจสอบสิทธิ์: Session

พารามิเตอร์

ชื่อ	ประเภท	จำเป็น	คำอธิบาย
page	number	ไม่	หมายเลขหน้า
pageSize	number	ไม่	รายการต่อหน้า

เฉพาะผู้ใช้ที่เข้าสู่ระบบ

Example

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

POST/api/apikeys

สร้าง API key ใหม่ คีย์ข้อความจะถูกคืนค่าเพียงครั้งเดียว

การตรวจสอบสิทธิ์: Session

พารามิเตอร์

ชื่อ	ประเภท	จำเป็น	คำอธิบาย
title	string	ใช่	ชื่ออธิบายสำหรับ key

เฉพาะผู้ใช้ที่เข้าสู่ระบบ

Example

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