Tài liệu API

Tích hợp tìm kiếm ảnh chụp màn hình anime vào ứng dụng của bạn qua API công khai.

Hạn mức miễn phí

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

Lưu ý xác thực

Các endpoint dựa trên phiên yêu cầu cookie phiên better-auth hợp lệ. Khi gọi từ phía server hoặc client không phải trình duyệt, hãy thêm header Origin (ví dụ: Origin: https://your-domain.com) và lưu cookie được trả về từ /api/auth/sign-in/email.

POST/api/anime/search

Tìm kiếm cảnh anime bằng cách tải lên tệp hình ảnh hoặc cung cấp URL hình ảnh. Trả về tối đa 5 kết quả khớp với timestamp và điểm tương đồng.

Xác thực: Session hoặc API key

Tham số

Tên	Kiểu	Bắt buộc	Mô tả
image	File	Không	Tệp hình ảnh (JPEG/PNG)
url	string	Không	URL hình ảnh công khai

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

Lấy bảng xếp hạng anime được tìm kiếm nhiều nhất theo kỳ.

Xác thực: Không

Tham số

Tên	Kiểu	Bắt buộc	Mô tả
period	string	Không	daily \| weekly \| monthly \| yearly \| all (mặc định: all)
limit	number	Không	Kết quả tối đa (mặc định: 50)
includeAdult	boolean	Không	Bao gồm mục NSFW (mặc định: false)

Không yêu cầu xác thực.

Example

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

GET/api/anime/recent-searches

Lấy các tìm kiếm công khai vừa được xác nhận.

Xác thực: Không

Tham số

Tên	Kiểu	Bắt buộc	Mô tả
limit	number	Không	Kết quả tối đa
offset	number	Không	Offset phân trang

Endpoint công khai.

Example

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

GET/api/user/anime-credits

Lấy số credit tìm kiếm anime còn lại của ngường dùng đã đăng nhập.

Xác thực: Session

Chỉ dành cho ngường dùng đã đăng nhập.

Example

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

GET/api/apikeys

Liệt kê các API key của bạn.

Xác thực: Session

Tham số

Tên	Kiểu	Bắt buộc	Mô tả
page	number	Không	Số trang
pageSize	number	Không	Số mục mỗi trang

Chỉ dành cho ngường dùng đã đăng nhập.

Example

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

POST/api/apikeys

Tạo API key mới. Khóa dạng văn bản chỉ được trả về một lần.

Xác thực: Session

Tham số

Tên	Kiểu	Bắt buộc	Mô tả
title	string	Có	Tên mô tả cho key

Chỉ dành cho ngường dùng đã đăng nhập.

Example

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