Documentação da API

Integre a pesquisa de screenshots de anime ao seu app com nossa API pública.

Cota gratuita

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

Notas de autenticação

Endpoints baseados em sessão exigem um cookie de sessão better-auth válido. Ao chamar do servidor ou de clientes não navegador, inclua o header Origin (ex: Origin: https://your-domain.com) e armazene o cookie retornado por /api/auth/sign-in/email.

POST/api/anime/search

Pesquise uma cena de anime fazendo upload de um arquivo de imagem ou fornecendo uma URL de imagem. Retorna até 5 correspondências com timestamps e scores de similaridade.

Autenticação: Session ou API key

Parâmetros

Nome	Tipo	Obrigatório	Descrição
image	File	Não	Arquivo de imagem (JPEG/PNG)
url	string	Não	URL de imagem pública

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

Busque o ranking de animes mais pesquisados por período.

Autenticação: Nenhuma

Parâmetros

Nome	Tipo	Obrigatório	Descrição
period	string	Não	daily \| weekly \| monthly \| yearly \| all (padrão: all)
limit	number	Não	Máx. resultados (padrão: 50)
includeAdult	boolean	Não	Incluir entradas NSFW (padrão: false)

Não requer autenticação.

Example

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

GET/api/anime/recent-searches

Busque pesquisas públicas recentemente confirmadas.

Autenticação: Nenhuma

Parâmetros

Nome	Tipo	Obrigatório	Descrição
limit	number	Não	Máx. resultados
offset	number	Não	Offset de paginação

Endpoint público.

Example

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

GET/api/user/anime-credits

Obtenha os créditos de pesquisa de anime restantes do usuário logado.

Autenticação: Session

Apenas usuários logados.

Example

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

GET/api/apikeys

Liste suas API keys.

Autenticação: Session

Parâmetros

Nome	Tipo	Obrigatório	Descrição
page	number	Não	Número da página
pageSize	number	Não	Itens por página

Apenas usuários logados.

Example

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

POST/api/apikeys

Crie uma nova API key. A chave em texto plano é retornada apenas uma vez.

Autenticação: Session

Parâmetros

Nome	Tipo	Obrigatório	Descrição
title	string	Sim	Nome descritivo para a key

Apenas usuários logados.

Example

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