Overview
The anime and manga features let you search for titles, view detailed information, and check AniList user statistics. All data is fetched in real-time from AniList’s API.Anime search
Look up detailed anime information
Manga search
Find manga titles and details
User profiles
View AniList user statistics
Account linking
Connect your AniList account
Anime search
Search for anime titles and get comprehensive information including synopsis, ratings, episode count, and more.Usage
Parameters
search(required) - The anime title you want to search for
Example
You can search using English titles, romanized titles, or native Japanese titles. AniList’s search is flexible and will find matches across all title variations.
What you get
When you search for an anime, Yato displays:- Title - Primary title and alternative titles
- Synopsis - Plot description
- Episode count - Number of episodes
- Status - Airing status (Finished, Currently Airing, Not Yet Released)
- Score - Average user rating
- Format - TV, Movie, OVA, etc.
- Season - Release season and year
- Genres - List of genres
- Studios - Production studios
- Cover image - Official artwork
Interactive navigation
If multiple results are found, you can navigate between them using Next/Back buttons:- Single result
- Multiple results
- No results
When only one match is found, it displays immediately with full details.
Manga search
Search for manga titles with the same detailed information as anime search.Usage
Parameters
search(required) - The manga title you want to search for
Example
What you get
Manga search results include:- Title - Primary and alternative titles
- Synopsis - Story description
- Chapter count - Total chapters
- Volume count - Total volumes
- Status - Publishing status (Finished, Releasing, Not Yet Released)
- Score - Average user rating
- Format - Manga, Light Novel, One-shot, etc.
- Start date - Publication start date
- Genres - List of genres
- Cover image - Official artwork
Interactive features
Just like anime search, manga search supports:- Multiple result navigation with Next/Back buttons
- 60-second interaction window
- Real-time data from AniList
Both anime and manga searches use the same interactive button system. Only the user who ran the command can use the navigation buttons.
AniList profiles
View detailed statistics from AniList user profiles, including anime and manga watching/reading history, favorites, and more.Usage
Parameters
user(optional) - Select a Discord user who has linked their AniList accountusername(optional) - Enter an AniList username directly- No parameters - View your own linked AniList stats
Examples
- Your own stats
- Discord user lookup
- Direct username lookup
Profile statistics
AniList profile displays include: Anime statistics:- Episodes watched
- Days spent watching
- Mean score
- Watching count
- Planned count
- On hold count
- Dropped count
- Repeating count
- Completed count
- Total anime in list
- Chapters read
- Volumes read
- Mean score
- Reading count
- Planned count
- On hold count
- Dropped count
- Repeating count
- Completed count
- Total manga in list
- Favorite character
- Favorite anime
- Favorite manga
- Favorite studio
- Profile banner image
- Profile color (matches user’s AniList theme)
- Direct link to AniList profile
The embed color automatically matches the user’s AniList profile color preference (purple, red, pink, blue, orange, gray, or green).
Linking accounts
To use/al without specifying a username every time, users need to link their AniList account with Yato.
Link your account
Use theset command to link your AniList account:
The specific syntax for the
set command may vary. Check /help set for detailed instructions on linking your AniList account.Benefits of linking
- Quick access to your stats with just
/al - Let server members view your profile via
/al user:@you - Automatic profile updates as you watch/read
Account not linked errors
If you try to use/al without linking your account:
You have not linked your account with Yato. Use set command to link your account
If you try to view another user’s profile and they haven’t linked:
The user has not linked their account with Yato
Error handling
Invalid username (404)
Rate limiting (429)
Unknown errors
Cooldowns
To prevent API abuse and ensure fair usage:- Anime search: 20 second cooldown
- Manga search: 20 second cooldown
- AniList profiles: 10 second cooldown
Best practices
Search tips
- Be specific: “Attack on Titan Season 2” is better than just “Attack”
- Try variations: If you don’t find what you’re looking for, try the Japanese title
- Use common names: Use the most popular English title for better results
Using in servers
- Create a dedicated anime/manga channel for searches
- Encourage members to link their AniList accounts
- Share interesting finds with the community
- Use during anime watching events or discussions
Data source
All anime and manga data comes from AniList (https://anilist.co), a comprehensive anime and manga database and social network for anime fans. AniList provides:- Up-to-date information on thousands of titles
- User-generated ratings and reviews
- Seasonal charts and trending titles
- Extensive metadata and relationships