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ênKiểuBắt buộcMô tả
imageFileKhôngTệp hình ảnh (JPEG/PNG)
urlstringKhôngURL 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ênKiểuBắt buộcMô tả
periodstringKhôngdaily | weekly | monthly | yearly | all (mặc định: all)
limitnumberKhôngKết quả tối đa (mặc định: 50)
includeAdultbooleanKhôngBao 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ênKiểuBắt buộcMô tả
limitnumberKhôngKết quả tối đa
offsetnumberKhôngOffset 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ênKiểuBắt buộcMô tả
pagenumberKhôngSố trang
pageSizenumberKhôngSố 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ênKiểuBắt buộcMô tả
titlestringTê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"}'