jikan-clj
January 29, 2026 · View on GitHub
A Clojure wrapper for the Jikan API (v4), the most popular open-source MyAnimeList component.
Status
Alpha - This project is in its early stages. Breaking changes may occur as we expand API coverage.
Installation
Add the following dependency to your deps.edn:
com.adaiasmagdiel/jikan-clj {:mvn/version "0.2.0"}
Usage
Require the library in your namespace:
(ns my-app.core
(:require [com.adaiasmagdiel.jikan-clj :as jikan]))
;; --- Configuration (Optional) ---
;; Set a custom base URL (e.g., for proxies or local mocks)
(jikan/configure {:base-url "https://my-proxy-server.com/v4"})
;; --- Anime ---
;; Fetch basic anime details by ID
(jikan/anime 1) ;; GET /anime/1
;; Fetch full anime details (including relations and external links)
(jikan/anime 1 true) ;; GET /anime/1/full
;; Get characters and staff
(jikan/anime-characters 1) ;; GET /anime/1/characters
;; Get all episodes
(jikan/anime-episodes 1) ;; GET /anime/1/episodes
;; Get specific episode details
(jikan/anime-episodes 1 12) ;; GET /anime/1/episodes/12
API Support
| Function | API Endpoint | Description |
|---|---|---|
configure | N/A | Global settings (base-url, etc) |
anime | GET /anime/{id} | Basic anime details |
anime | GET /anime/{id}/full | Full anime details |
anime-characters | GET /anime/{id}/characters | Characters and Staff |
anime-episodes | GET /anime/{id}/episodes | List of episodes |
anime-episodes | GET /anime/{id}/episodes/{id} | Specific episode info |
Development
Building the JAR
To clean the target folder and build a new JAR file:
clj -T:build clean
clj -T:build jar
Running Tests
clj -M:test
License
Copyright © 2026 Adaías Magdiel
This program and the accompanying materials are made available under the terms of the GNU General Public License v3.0. See LICENSE and COPYRIGHT for more details.