added MAL2Go/user/anime docs

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.