Nogitsu API
Uma API JSON gratuita e somente leitura para tudo o que é público no Nogitsu: o catálogo de anime e mangá, personagens, pessoas e empresas, notícias, trailers, o calendário de exibição, resenhas, comunidades e listas públicas dos membros.
- Endereço base
- https://api.nogitsu.com
Sua primeira requisição
Cada operação é uma simples requisição GET. Não há chave para criar nem nada para assinar. Esta requisição retorna as três obras mais populares:
curl "https://api.nogitsu.com/v1/works?limit=3"A resposta é JSON. As listas colocam os resultados em items e o endereço da próxima página em nextCursor:
{
"items": [
{
"id": "01a0cac5-388a-75ed-a3a6-4a5d2db4261e",
"slug": "solo-leveling",
"medium": "manhwa",
"primaryTitle": "Solo Leveling",
"aggregateScore": 850,
"popularityRank": 1
},
{
"id": "01a0cb02-0a14-7877-911d-5b4dde76df72",
"slug": "attack-on-titan",
"medium": "anime",
"primaryTitle": "Attack on Titan",
"aggregateScore": 847,
"popularityRank": 1
},
{
"id": "01a0cb0a-37c1-7946-be38-bfc9f1a5af0e",
"slug": "berserk",
"medium": "manga",
"primaryTitle": "Berserk",
"aggregateScore": 908,
"popularityRank": 1
}
],
"nextCursor": "eyJ2YWx1ZSI6MSwiaWQiOiIwMWEwY2IwYS0zN2MxLTc5NDYtYmUzOC1iZmM5ZjFhNWFmMGUifQ"
}O que saber primeiro
- Sem chave, token ou cadastro.
- Somente leitura: apenas o que é público em nogitsu.com.
- Chame-a a partir do seu servidor; navegadores em outros sites são bloqueados.
- 120 requisições por minuto para cada endereço.
- Gratuita para uso não comercial, com crédito ao Nogitsu.
Guias
- Acesso e requisiçõesSem chave, somente leitura, no servidor; formatos de IDs, datas e valores ausentes.
- Páginas e cursoresComo as operações de lista dividem os resultados em páginas e como ler a próxima.
- ErrosO formato único dos erros, os códigos de status e o que fazer em cada caso.
- Limites de requisições e cacheQuantas requisições você pode enviar, os cabeçalhos que informam isso e o que manter em cache.
- IdiomasComo obter descrições e rótulos em um dos doze idiomas do site.
- ImagensCapas, banners e retratos: tamanhos, cópias AVIF menores e direitos.
- Licença e créditoO que você pode fazer com os dados, como dar crédito ao Nogitsu e o que fica de fora.
Operações por tema
- Obras6 operaçõesO catálogo de anime, donghua, animação, mangá, manhwa, manhua e webtoons: listas com filtros, obras individuais e o vocabulário de gêneros.
- Detalhes da obra10 operaçõesTudo o que está na página de uma obra além do resumo: episódios e capítulos, personagens, equipe, obras relacionadas, trailers, imagens, onde assistir ou ler e estatísticas dos membros.
- Busca4 operaçõesBusca por texto em obras e em personagens, pessoas e empresas, e a busca filtrada por trás da página Explorar.
- Personagens3 operaçõesO diretório de personagens e as páginas de personagens com as obras em que aparecem.
- Pessoas4 operaçõesDubladores, autores, artistas e equipe, com seus créditos e papéis de voz.
- Empresas3 operaçõesEstúdios, editoras e outras empresas, com as obras em que recebem crédito.
- Notícias3 operaçõesNotícias escritas a partir de eventos do catálogo: estreias e encerramentos, datas, retornos de pausa, anúncios de continuação e novos trailers.
- Trailers2 operaçõesO Cantinho dos trailers: trailers novos, em breve, da temporada e populares, e trailers individuais.
- Calendário2 operaçõesEpisódios com horário exato de exibição, para os próximos dias ou para um intervalo de datas.
- Resenhas6 operaçõesResenhas de obras escritas por membros, o resumo das resenhas de uma obra e os melhores resenhistas do mês.
- Comunidades8 operaçõesComunidades do fórum em cada idioma, a comunidade de uma obra, tendências e quantas pessoas estão online.
- Posts e comentários11 operaçõesPosts do fórum, árvores de comentários, textos de spoiler ocultos e as conversas de comentários de obras, personagens, pessoas, empresas e resenhas.
- Listas6 operaçõesListas públicas criadas por membros e as obras que elas contêm.
- Membros13 operaçõesPerfis públicos dos membros e as partes que cada membro escolheu mostrar.