Table of Contents

LiSA API Documentation

Endpoints

1. Home

GET /

Description: Checks if all servers started successfully.

Response: Plain text response indicating server status.

2. Search

GET /search

Description: Searches for anime or manga.

Query Parameters:

  • type (optional): Type of search. Default is "anime". Can be "anime" or "manga".
  • query: Search term.
  • total_res (optional): Maximum number of results to return. Default is 9 for anime, 20 for manga.
  • page (optional, for manga): Page number for results. Default is 1.

Response: JSON object containing search results.

3. Get Episode Details

GET /ep_details

Description: Retrieves episode details for a specific anime.

Query Parameters:

  • anime_session or anime_id: Anime session or ID.
  • page (optional): Page number. Default is "1".

Response: JSON object containing episode details.

4. Get Manga Detail

GET /manga_detail

Description: Retrieves details for a specific manga.

Query Parameters:

  • session: Manga session ID.

Response: JSON object containing manga details.

5. Get Stream Details

GET /stream_detail

Description: Retrieves streaming details for a specific episode.

Query Parameters:

  • anime_session: Anime session ID.
  • ep_session: Episode session ID.

Response: JSON object containing streaming details.

6. Stream

POST /stream

Description: Initiates streaming for a specific episode.

Request Body: JSON object with:

  • player: Video player name.
  • manifest_url or id: Manifest URL or video ID.

Response: JSON object with status or error message.

7. Read Manga

GET /read

Description: Retrieves manga chapter data for reading.

Query Parameters:

  • chp_session or id: Chapter session or manga ID.

Response: JSON array of image URLs.

8. Download

POST /download

Description: Initiates a download for anime or manga.

Request Body: JSON object with download details (anime_session, manga_session, manifest_url, etc.)

Response: JSON object with download status.

9. Download Management

POST /download/pause POST /download/resume POST /download/cancel

Description: Manages ongoing downloads.

Request Body: JSON object with:

  • id: Array of download IDs.

Response: JSON object with status message.

10. Library

GET /library DELETE /library

Description: Retrieves or deletes library items.

Query Parameters:

  • status (optional, for GET): Filter by status. Default is "downloaded".
  • id (for DELETE): ID of the item to delete.

Response:

  • GET: JSON object with library data.
  • DELETE: No content (204) on success.

11. Top Anime/Manga

GET /top

Description: Retrieves top anime or manga.

Query Parameters:

  • type: "anime" or "manga".
  • c: Category (e.g., "airing", "upcoming", "tv", "movie", etc. for anime; "manga", "novels", "oneshots", etc. for manga).
  • limit (optional): Number of results to return.

Response: JSON object with top anime/manga data.

12. Get Master Manifest

GET /master_manifest

Description: Retrieves the master manifest for streaming.

Query Parameters:

  • kwik_url: Comma-separated list of Kwik URLs.

Response: M3U8 file content.

13. Get Manifest

GET /manifest

Description: Retrieves the manifest for a specific stream.

Query Parameters:

  • kwik_url: Kwik URL for the stream.

Response: M3U8 file content.

14. Proxy

GET /proxy

Description: Proxies requests for manifest files, encryption keys, and video frames.

Query Parameters:

  • url: The actual URL to proxy.

Response: Proxied content with appropriate headers.

15. Get Recommendation

GET /recommendation

Description: Retrieves recommendations for anime or manga.

Query Parameters:

  • type: "anime" or "manga".
  • anime_session or manga_session: Session ID of the anime or manga.

Response: JSON object with recommendations.

16. Watchlist/Readlist

GET /watchlist POST /watchlist DELETE /watchlist GET /readlist POST /readlist DELETE /readlist

Description: Manages watchlist for anime and readlist for manga.

Query Parameters (for DELETE):

  • anime_id or manga_id: ID of the item to remove.

Request Body (for POST): JSON object with anime/manga details.

Response:

  • GET: JSON object with watchlist/readlist data.
  • POST: JSON object confirming addition.
  • DELETE: No content (204) on success.