novelbin.me APInovelbin.me ↗
Access NovelBin novel data via API: search, full details, chapter content, genre listings, reader comments, bookmarks, and more across 15 endpoints.
curl -X GET 'https://api.parse.bot/scraper/386a2968-f8d8-4fd3-b5da-8c640e6db70b/search_novels?query=shadow+slave' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for novels by keyword. Returns matching novel titles, authors, cover images, and latest chapter info.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'shadow slave', 'cultivation') |
{
"type": "object",
"fields": {
"items": "array of novel objects with title, slug, author, image_url, and latest_chapter",
"query": "the search keyword used"
},
"sample": {
"data": {
"items": [
{
"slug": "shadow-slave",
"title": "Shadow Slave",
"author": "Guiltythree",
"image_url": "https://images.novelbin.com/novel_200_89/shadow-slave.jpg",
"latest_chapter": {
"slug": null,
"title": "Chapter 2984 The Sword of Theseus"
}
}
],
"query": "shadow slave"
},
"status": "success"
}
}About the novelbin.me API
The NovelBin API gives developers structured access to NovelBin.me across 15 endpoints covering novel search, full metadata, chapter listings, and chapter text. The get_chapter_content endpoint returns complete prose for any chapter by novel and chapter slug. Other endpoints expose trending, popular, and completed novel lists, genre-filtered browsing, reader comments with sort control, and authenticated actions like bookmarking and update subscriptions.
Novel Discovery and Metadata
The search_novels endpoint accepts a query string and returns matching novels with title, slug, author, image_url, and latest_chapter. Once you have a slug, get_novel_details returns the full record: genres (array of strings), rating (object with score and count), status (Ongoing or Completed), description, and cover_image_url. The get_related_novels endpoint takes the same slug and returns novels that share the same genre, useful for recommendation flows.
Browsing and Filtering
Four listing endpoints — get_latest_release_novels, get_hot_novels, get_most_popular_novels, and get_completed_novels — all accept an optional page integer and return paginated arrays of novel objects. To filter by genre, call get_genres_list first to retrieve the full array of accepted genre name strings, then pass one to get_novels_by_genre alongside an optional page parameter. This avoids guessing genre slugs.
Chapter Access and Comments
get_novel_chapters returns the complete chapter list for a novel as an array of objects each containing title and slug. Pass any chapter_slug from that list to get_chapter_content along with the novel_slug to receive the full content text. For reader commentary, get_novel_comments supports skip-based pagination and a sort field accepting latest or oldest, returning per-comment username, content, time, likes, and dislikes.
Authenticated User Actions
The login endpoint accepts email and password and establishes a session used by subsequent calls. add_to_bookmark takes a slug and an optional status field — reading, plan_to_read, completed, or dropped — enabling reading-list management. subscribe_to_novel takes a slug and returns a success boolean indicating whether the subscription was recorded.
- Build a novel recommendation engine using
get_related_novelsand genre metadata fromget_novel_details. - Track newly updated titles by polling
get_latest_release_novelsand diffing slugs against a stored list. - Populate a reading-progress tracker using
get_novel_chapterschapter counts andadd_to_bookmarkstatus fields. - Aggregate reader sentiment by collecting
likes,dislikes, andcontentfields fromget_novel_comments. - Create a genre-browsing interface by combining
get_genres_listwith paginated results fromget_novels_by_genre. - Mirror chapter text for offline reading apps using
get_chapter_contentwith novel and chapter slugs. - Build a trending dashboard by comparing data from
get_hot_novelsandget_most_popular_novels.
| 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 NovelBin have an official developer API?+
What does `get_novel_details` return beyond the title and author?+
get_novel_details returns genres as an array of strings, a rating object containing score and count, status (such as 'Ongoing' or 'Completed'), a description synopsis, and cover_image_url. It does not return chapter count or view count directly — those fields are not in the response. You can fork this API on Parse and revise it to add the missing endpoint if those fields are available on the source page.How does pagination work across the listing endpoints?+
get_latest_release_novels, get_hot_novels, get_most_popular_novels, get_completed_novels, get_novels_by_genre) all accept an optional page integer. The response echoes back the page value alongside the items array. There is no total_pages or total_count field in the response, so callers must probe forward until an empty items array is returned.Can I retrieve a user's existing bookmark list or reading history?+
add_to_bookmark and setting a reading status, but it does not expose an endpoint to fetch a user's existing bookmark list or reading history. You can fork this API on Parse and revise it to add the missing endpoint.Does `get_novel_comments` return replies to comments or only top-level comments?+
comments array returns objects with username, content, time, likes, and dislikes. There is no replies field or nested comment structure in the response, so only top-level comments are returned. You can fork this API on Parse and revise it to add reply threading if the source exposes that data.