mangalib.org APImangalib.org ↗
Access MangaLib's manga catalog, chapter pages, search, comments, and cover images via a structured API. 9 endpoints returning paginated, filterable manga data.
curl -X GET 'https://api.parse.bot/scraper/046de2fd-2491-48f4-8b74-ed3e7b16ba31/get_catalog?page=1&sort_by=rate_avg&sort_type=desc' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the manga catalog with optional filtering by genres, types, and sorting. Returns paginated results from the MangaLib catalog.
| Param | Type | Description |
|---|---|---|
| name | string | Filter by name (partial match). Note: some queries may return upstream errors depending on backend availability. |
| page | integer | Page number for pagination. |
| types | string | Comma-separated type IDs to filter by (e.g. '1,5,6'). |
| genres | string | Comma-separated genre IDs to filter by (e.g. '1,2,3'). |
| sort_by | string | Sort field. Accepted values: rate_avg, name, created_at, last_chapter_at, views, chap_count. |
| sort_type | string | Sort direction. Accepted values: asc, desc. |
{
"type": "object",
"fields": {
"data": "array of manga objects with id, name, rus_name, eng_name, slug_url, cover, type, rating, status"
},
"sample": {
"data": {
"data": [
{
"id": 206,
"name": "One Piece",
"type": {
"id": 1,
"label": "Манга"
},
"cover": {
"default": "https://cover.imglib.info/uploads/cover/one-piece/cover/baed4803-df48-4d82-b173-1a9f68e85985.jpg",
"thumbnail": "https://cover.imglib.info/uploads/cover/one-piece/cover/baed4803-df48-4d82-b173-1a9f68e85985_thumb.jpg"
},
"rating": {
"votes": 95000,
"average": "9.72"
},
"eng_name": "One Piece",
"rus_name": "Ван Пис",
"slug_url": "206--one-piece"
}
],
"meta": {
"page": 1,
"has_next_page": true
}
},
"status": "success"
}
}About the mangalib.org API
The MangaLib API exposes 9 endpoints covering the full manga browsing and reading workflow on mangalib.org. You can search titles by keyword with search_titles, pull paginated catalog results filtered by genre, type, and sort order via get_catalog, retrieve per-chapter page image URLs including width and height, fetch user comments with pagination, and get cover and banner image URLs for any title.
Catalog and Search
The get_catalog endpoint returns paginated manga objects — each with id, name, rus_name, eng_name, slug_url, cover, type, rating, and status — and accepts filters for genres (comma-separated genre IDs), types (comma-separated type IDs), and six sort_by options including rate_avg, views, chap_count, and last_chapter_at. The search_titles endpoint accepts a single query string and returns the same shape for quick keyword lookups. Both endpoints produce slug_url values used as input to every other endpoint.
Manga Details and Chapters
get_manga_details returns a full metadata object for a single title: summary, genres, tags, authors, rating, status, and chap_count. get_manga_chapters returns the ordered chapter list with volume, number, name, branches_count, and branches per entry. To retrieve readable page images, pass the matching slug_url, volume, and chapter number to get_chapter_pages, which returns a pages array where each item includes slug, url, width, and height.
Discovery and Community Data
get_currently_reading requires no inputs and returns a snapshot of MangaLib's homepage data: popular, newest, latest_updates, collections, reviews, currently_views, weekly_top_users, and news. get_manga_comments accepts a numeric manga_id and an optional page parameter, returning separate root and replies arrays alongside pagination meta. get_random_title returns one randomly selected manga object with the same basic metadata fields as catalog results. get_manga_cover_image returns three distinct image URLs — thumbnail_url, cover_image_url, and banner_image_url — for a given slug_url.
- Build a manga discovery app that filters the catalog by genre IDs and sorts by
rate_avgto surface top-rated titles. - Generate a reading progress tracker by listing all chapters via
get_manga_chaptersand fetching pages withget_chapter_pages. - Display author, tag, and summary data from
get_manga_detailson a title information page. - Create a trending dashboard using the
popular,latest_updates, andweekly_top_usersfields fromget_currently_reading. - Build a comment feed or moderation tool using paginated comment data from
get_manga_comments. - Populate manga cards with cover and banner art using the three image URLs returned by
get_manga_cover_image. - Implement a random manga recommendation button backed by
get_random_title.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MangaLib have an official developer API?+
How do genres and types filtering work in get_catalog?+
genres and types accept comma-separated numeric ID strings (e.g. genres=1,2,3). You can combine them with any sort_by value — rate_avg, name, created_at, last_chapter_at, views, or chap_count — and a sort_type of asc or desc. Note that the name filter may return upstream errors depending on backend availability at the time of the request.Does get_chapter_pages return the actual image files?+
url string along with width and height dimensions. Your client fetches the images from those URLs directly.