🌟 Animesage API

Welcome to the Animesage API documentation. This API provides various endpoints to access anime-related data.

📖 Table of Contents

• 🌐 Base URL
• 📚 Endpoints (v1)
  • 🎥 Detailed Anime Info
  • 📺 Episodes Info
  • 📄 Anime by Page
  • 🔍 Search by Title
  • 🔥 Trending Anime
  • 🌟 Popular Anime
  • 🎬 Stream Links
  • 🎲 Random Anime
  • 📅 Latest Airing Anime
• 🚦 Rate Limits (v1)
• 📧 Contact for Higher Rate Limits
• 👤 Developer
• 📖 Documentation
• 📋 Changelog
• 📜 Code of Conduct
• 🤝 Contributing
• 🙏 Thanks/Credits
• 📜 License

🌐 Base URL

• Base URL: https://api.animesage.online/
• Version 1 Base URL: https://api.animesage.online/v1

📚 Endpoints (v1)

1. 🎥 Get Detailed Information About a Specific Anime

• Endpoint: GET /v1/anime/:animeId/info

• Description: Retrieve comprehensive details about a specific anime.

• Path Parameters:

  Parameter	Type	Required	Description
  animeId	integer/string	Yes	The unique identifier for the anime.

• Query Parameters:

  Parameter	Type	Default	Required	Options	Description
  provider	string	anilist	No	anilist mal gogo zoro pahe notifymoe kitsu anidb livechart anisearch animeplanet	Specifies the provider of the anime ID.

• Example:

  curl -X GET "https://api.animesage.online/v1/anime/1/info?provider=anilist"

2. 📺 Get All Episodes Info of a Specific Anime

• Endpoint: GET /v1/anime/:animeId/episodes

• Description: Fetch information on all episodes of a specific anime.

• Path Parameters:

  Parameter	Type	Required	Description
  animeId	integer/string	Yes	The unique identifier for the anime.

• Query Parameters:

  Parameter	Type	Default	Required	Options	Description
  provider	string	anilist	No	anilist mal gogo zoro pahe notifymoe kitsu anidb livechart anisearch animeplanet	Specifies the provider of the anime ID.

• Example:

  curl -X GET "https://api.animesage.online/v1/anime/1/episodes?provider=anilist"

3. 📄 Get All Anime Information by Page

• Endpoint: GET /v1/anime/info/page/:page

• Description: Access a paginated list of anime information.

• Path Parameters:

  Parameter	Type	Required	Description
  page	integer	Yes	The page number to retrieve.

• Query Parameters:

  Parameter	Type	Default	Required	Description
  limit	integer	20	No	Number of results per page. Min: 1, Max: 50
  year	integer		No	Filter by release year.
  season	string		No	Options: winter spring summer fall

• Example:

  curl -X GET "https://api.animesage.online/v1/anime/info/page/1?limit=50&year=2023&season=winter"

4. 🔍 Search for an Anime by Title

• Endpoint: GET /v1/anime/search-by-title/:title

• Description: Look up an anime using its title.

• Path Parameters:

  Parameter	Type	Required	Description
  title	string	Yes	The title of the anime to search for.

• Query Parameters:

  Parameter	Type	Default	Required	Description
  page	integer	1	No	The page number to retrieve.
  limit	integer	20	No	Number of results per page. Min: 1, Max: 50

• Example:

  curl -X GET "https://api.animesage.online/v1/anime/search-by-title/reincarnated+as+slime?page=1&limit=50"

5. 🔥 Get Trending Anime

• Endpoint: GET /v1/anime/trending

• Description: Discover currently trending anime.

• Query Parameters:

  Parameter	Type	Default	Required	Description
  page	integer	1	No	The page number to retrieve.
  limit	integer	20	No	Number of results per page. Min: 1, Max: 50

• Example:

  curl -X GET "https://api.animesage.online/v1/anime/trending?page=1&limit=50"

6. 🌟 Get Popular Anime

• Endpoint: GET /v1/anime/popular

• Description: Explore popular anime titles.

• Query Parameters:

  Parameter	Type	Default	Required	Description
  page	integer	1	No	The page number to retrieve.
  limit	integer	20	No	Number of results per page. Min: 1, Max: 50

• Example:

  curl -X GET "https://api.animesage.online/v1/anime/popular?page=1&limit=50"

7. 🎬 Get Stream Links for a Specific Anime Episode

• Endpoint: GET /v1/anime/:animeId/stream/:episodeNumber

• Description: Obtain streaming links for a specific episode of an anime.

• Path Parameters:

  Parameter	Type	Required	Description
  animeId	integer/string	Yes	The unique identifier for the anime.
  episodeNumber	integer	Yes	The episode number.

• Query Parameters:

  Parameter	Type	Default	Required	Options	Description
  type	string	sub	No	sub dub	Specifies the type of the anime.
  provider	string	anilist	No	anilist mal gogo	Specifies the provider of the anime ID.

• Example:

  curl -X GET "https://api.animesage.online/v1/anime/1/stream/1?type=sub&provider=anilist"

8. 🎲 Get a Random Anime

• Endpoint: GET /v1/anime/random

• Description: Fetch a random anime title.

• Example:

  curl -X GET "https://api.animesage.online/v1/anime/random"

9. 📅 Get All Latest Airing Anime

• Endpoint: GET /v1/anime/latest-anime

• Description: Access a list of the latest airing anime.

• Query Parameters:

  Parameter	Type	Default	Required	Description
  page	integer	1	No	The page number to retrieve.
  limit	integer	20	No	Number of results per page. Min: 1, Max: 50

• Example:

  curl -X GET "https://api.animesage.online/v1/anime/latest-anime?page=1&limit=50"

🚦 Rate Limits (v1)

To ensure fair usage and maintain performance, the Animesage API enforces the following rate limits:

🕒 Time Frame	🚀 Requests Allowed	🌟 Description
⏱️ Per Minute	120 requests	Maximum number of requests allowed per minute.
⏰ Per Second	10 requests	Maximum number of requests allowed per second.

Note: Exceeding these limits will result in a 1-minute timeout from accessing the API. Please ensure your application handles rate limit responses gracefully.

📧 Contact for Higher Rate Limits

If you are a developer creating an app, website, or project and require a higher rate limit, please feel free to contact me at [email protected] for further discussion.

👤 Developer

• Name: Sandipan
• GitHub: Sandipan Singh GitHub
• Email: [email protected]

📖 Documentation

For more detailed documentation, visit Animesage API Docs.

📋 Changelog

For a detailed list of changes, please refer to the Changelog.

📜 Code of Conduct

Please read our Code of Conduct to understand the standards we expect from our community.

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for more details on how to get started.

🙏 Thanks/Credits

• Special thanks to the following projects and contributors for their support and resources:

• Anilist-ApiV2 by AniList

• jikan-rest by Jikan

• consumet.ts by consumet

• mal-backup by bal-mackup

• anime-lists by Fribb

• gogoanime-I & gogoanime-II

• amvstrm for the inspiration and ideas on how to structure the project.

📜 License

This project is licensed under the Custom BY-NC License.

---

© 2024 Animesage-Online. All Rights Reserved.

---