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개의 후보를 반환합니다.
인증: Session 또는 API key

매개변수

이름유형필수설명
imageFile아니오이미지 파일 (JPEG/PNG)
urlstring아니오공개 이미지 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
기간별로 가장 많이 검색된 애니메이션 순위를 가져옵니다.
인증: 없음

매개변수

이름유형필수설명
periodstring아니오daily | weekly | monthly | yearly | all (기본값: all)
limitnumber아니오최대 결과 수 (기본값: 50)
includeAdultboolean아니오NSFW 항목 포함 (기본값: false)

인증이 필요하지 않습니다.

Example

curl "https://whatanimeisthis.com/api/anime/rankings?period=daily&limit=10"
GET/api/anime/recent-searches
최근 확인된 공개 검색을 가져옵니다.
인증: 없음

매개변수

이름유형필수설명
limitnumber아니오최대 결과 수
offsetnumber아니오페이지네이션 오프셋

공개 엔드포인트.

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

매개변수

이름유형필수설명
pagenumber아니오페이지 번호
pageSizenumber아니오페이지당 항목 수

로그인 사용자 전용.

Example

curl "https://whatanimeisthis.com/api/apikeys" \
  -H "Cookie: <SESSION_COOKIE>"
POST/api/apikeys
새로운 API key를 생성합니다. 평문 키는 한 번만 반환됩니다.
인증: Session

매개변수

이름유형필수설명
titlestringkey에 대한 설명 이름

로그인 사용자 전용.

Example

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