A comfy, go-like library for Jikan, the open source MyAnimeList API.
$ go get github.com/nokusukun/jikan2go
The endpoint used by the API can be changed by modifying utils.Constants.API
package main
import (
"fmt"
"github.com/nokusukun/jikan2go/anime"
"github.com/nokusukun/jikan2go/utils"
)
func init() {
utils.Config.API = "https://jikan.noku.pw/v3" // All of jikan2go API calls will now use
// jikan.noku.pw instead of api.jikan.moe
utils.Config.CacheDir = "~/.jikan/" //change where cache files are stored (default: os.TempDir())
utils.Config.CacheLifetime = time.hour * 1 // change the cache lifetime before
// requesting data from the remote resource. (default 30 minutes)
}Note: Make sure to remove the trailing slash when specifying a new API endpoint.
While the library maintains a cache, it also respects Jikan's ETag headers.
All of the methods accepts anything that implements the MALItem interface and almost all of the
structs in this package implements the MALItem interface.
This means you can pass a common.AnimeItem or anything that is roughly anime related to anime.GetAnime or all of it's package's methods.
No type assertions are being checked (for now) when passing a struct in order to facilitate more freedom.
Can be found here.
Searching in jikan2go fully implements Jikan's Search Parameters
package main
import (
"fmt"
"github.com/nokusukun/jikan2go/anime"
)
func main() {
// Searching for Anime
result, _ := anime.Search(anime.Query{Q:"made in abyss"}) // same goes for manga.Search
madeInAbyss := result.Results[0]
fmt.Println("Title:", madeInAbyss.Title)
fmt.Println("Link:", madeInAbyss.URL)
// Retrieve recommendations for this particular anime
recs, _ := anime.GetRecommendations(madeInAbyss)
for _, recAnime := range recs.Recommendations[:3] {
fmt.Println(recAnime.Title, "is recommended by", recAnime.RecommendationCount, "users")
}
fmt.Println("---")
// Retrieving anime by it's MAL ID
mia, err := anime.GetAnime(anime.Anime{MalID:34599})
if err != nil {
panic(err)
}
fmt.Printf("Made in Abyss Description\n\n%v", mia.Synopsis)
}Output:
Title: Made in Abyss
Link: https://myanimelist.net/anime/34599/Made_in_Abyss
Shinsekai yori is recommended by 22 users
Hunter x Hunter (2011) is recommended by 21 users
Yakusoku no Neverland is recommended by 21 users
---
Made in Abyss Description
The Abyss—a gaping chasm stretching down into the depths of the earth, filled with mysterious creatures and relics from
a time long past. How did it come to be? What lies at the bottom? Countless brave individuals, known as Divers, have
sought to solve these mysteries of the Abyss, fearlessly descending into its darkest realms.
Note: The struct returned by anime.Search does not include the full canonical data, in this case, just feed the search result to anime.GetAnime
package main
import (
"fmt"
"github.com/nokusukun/jikan2go/anime"
"github.com/nokusukun/jikan2go/manga"
)
func main() {
result, _ := anime.Search(anime.Query{Q:"made in abyss"})
firstResult := result.Results[0]
fmt.Println("Title:", firstResult.Title)
fmt.Println("Link:", firstResult.URL)
madeInAbyss, _ := anime.GetAnime(firstResult)
miaManga, _ := manga.GetManga(madeInAbyss.Related.Adaptation[0])
fmt.Println("Made in Abyss Author: ", miaManga.Authors[0].Name)
}Output:
Title: Made in Abyss
Link: https://myanimelist.net/anime/34599/Made_in_Abyss
Made in Abyss Author: Tsukushi, Akihito
The api also implements several common elements such as genre, news, pictures, reviews and stats.
package main
import (
"fmt"
"github.com/nokusukun/jikan2go/anime"
"github.com/nokusukun/jikan2go/common"
"github.com/nokusukun/jikan2go/manga"
)
func main() {
result, _ := anime.Search(anime.Query{Q:"made in abyss"})
firstResult := result.Results[0]
fmt.Println("Title:", firstResult.Title)
fmt.Println("Link:", firstResult.URL)
fmt.Println("Members:", firstResult.Members)
madeInAbyss, _ := anime.GetAnime(firstResult)
miaManga, _ := manga.GetManga(madeInAbyss.Related.Adaptation[0])
fmt.Println("Made in Abyss Author: ", miaManga.Authors[0].Name)
news, _ := common.GetNews(madeInAbyss)
fmt.Println("\n---\nNews related to Made in Abyss")
fmt.Println(news.Articles[0].Title)
fmt.Println(news.Articles[0].URL)
}Output:
Title: Made in Abyss
Link: https://myanimelist.net/anime/34599/Made_in_Abyss
Members: 614368
Made in Abyss Author: Tsukushi, Akihito
---
News related to Made in Abyss
Interview: Kinema Citrus Staff Reflect on 'Made in Abyss'
https://myanimelist.net/news/58244750
package main
import (
"fmt"
"github.com/nokusukun/jikan2go/season"
)
func main() {
// Print 5 anime shows that aired on summer 2019
summer2019, err := season.GetSeason(season.Summer, 2019)
if err != nil {
panic(err)
}
for _, a := range summer2019.Anime[:5] {
fmt.Println("Title:", a.Title)
fmt.Println("Rating:", a.Score, "\n---")
}
}Output:
Title: Dr. Stone
Rating: 8.46
---
Title: Enen no Shouboutai
Rating: 7.78
---
Title: Vinland Saga
Rating: 8.78
---
Title: Dungeon ni Deai wo Motomeru no wa Machigatteiru Darou ka II
Rating: 7.31
---
Title: Arifureta Shokugyou de Sekai Saikyou
Rating: 6.52
---
func main() {
naux, err := GetUser(User{Username: "naux"})
assert.Nil(t, err)
assert.NotEqual(t, naux.Username, "")
fmt.Println(naux.UserID, naux.Username)
fmt.Println(naux.About)
}Output:
4435579 Naux
24y/o Asian that looks...
func main() {
club, _ := GetClub(Club{MalID:1})
fmt.Println(club.Title)
members, _ := GetMembers(club, 1)
fmt.Println("Members:", len(members.Members))
}Output:
Cowboy Bebop
Members: 36
- Package Testing
- Working On
- all of them
- Working On
- Common
- Implemented
- review
- genre
- news
- pictures
- stats
- Implemented
- Anime
- Implemented
- Request caching
- character_staff
- episodes
- recommendations
- search
- videos
- Back Burner
- forum
- more info
- user updates
- Implemented
- Manga
- Implemented
- characters
- recommendations
- search
- Back Burner
- forum
- more info
- user updates
- Implemented
- Person
- Implemented
- pictures
- Implemented
- Characters
- Implemented
- pictures
- Implemented
- Season
- Schedule
- Top
- Anime
- Manga
- Person
- Character
- Genre
- Producer
- Magazine
- User
- Club
Request CachingUserClub- Meta