diff options
Diffstat (limited to 'content/docs/mal2go/v4/user/anime/get-anime-list.md')
-rw-r--r-- | content/docs/mal2go/v4/user/anime/get-anime-list.md | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/content/docs/mal2go/v4/user/anime/get-anime-list.md b/content/docs/mal2go/v4/user/anime/get-anime-list.md new file mode 100644 index 0000000..22f6f4a --- /dev/null +++ b/content/docs/mal2go/v4/user/anime/get-anime-list.md @@ -0,0 +1,53 @@ +--- +title: "Get anime list" +description: "Get an arbitrary user's animelist" +weight: 2 +--- + +Use the `GetAnimeList` method to get the animelist of a user. +This method takes these arguments: + +- `username string` Username of the user to get animelist of. An empty string or `"@me"` will return the logged-in user's list +- `status string` Status of the animes, accepted values are `watching`, `completed`, `on_hold`, `dropped` and `plan_to_watch` +- `sort string` How to sort the list, accepted values are `list_score`, `list_updated_at`, `anime_title`, `anime_start_date` and `anime_id` +- `limit int` Limit of results to pull, Max is 1000 +- `offset int` Offset for the results +- `nsfw bool` To include NSFW elements or not +- `fields []string` Specify which fields to get for each anime. [List of valid fields](/docs/mal2go/v4/anime/types/#mal2goanimeanime) + +Example: + +``` go +package main + +import ( + "github.com/MikunoNaka/MAL2Go/v4/user/anime" + "log" + "fmt" +) + +func main() { + authToken := "YOUR_TOKEN_HERE" + myClient := anime.Client { + AuthToken: "Bearer " + authToken, + } + + animeList, nextPageExists, err := myClient.GetAnimeList("0ZeroTsu", "completed", "list_score", 1000, 0, true, []string{"title"}) + if err != nil { + log.Fatal(err) + } + + for _, i := range animeList { + fmt.Println(i.Title) + } + + if nextPageExists { + fmt.Println("This user has even more animes in their animelist.") + fmt.Println("Please increase the offset to look at the hidden entries.") + } +} +``` + +The above example prints the first 1000 entries from 0ZeroTsu's (mine) completed anime list. +If the list has more than 1000 items, the `nextPageExists` becomes true, which can be used to show +a notice like this, or maybe append the remaining items to animeList by calling `anime.GetAnimeList` with a higher offset. |