Ranobes APIranobes.top ↗
Access novel listings, chapter indexes, full chapter text, and book metadata from ranobes.top via 4 structured JSON endpoints.
What is the Ranobes API?
The Ranobes.top API provides 4 endpoints for retrieving novel data from ranobes.top, covering book discovery, chapter listings, full chapter text, and detailed book metadata. The get_chapter_content endpoint returns the complete text of any chapter identified by a numeric chapter_id, while get_books lets you browse the full catalog with genre and sort-order filters. Each response is structured JSON, making it straightforward to build reading apps, content trackers, or translation tools on top of the source.
curl -X GET 'https://api.parse.bot/scraper/74ef149f-8adf-4285-9aa9-55ba2645bcae/list_chapters?page=1&book_id=1205249' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ranobes-top-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Ranobes_API SDK — bounded, re-runnable; every call capped."""
from parse_apis.Ranobes_API import Ranobes, ChapterNotFound
client = Ranobes()
# Browse completed novels sorted by rating.
for novel in client.book_summaries.list(status="Completed", order="rating", limit=3):
print(novel.title, novel.rating, novel.status)
# Drill-down: get full details for the first result.
hit = client.book_summaries.list(genre="Fantasy", limit=1).first()
if hit:
book = hit.details()
print(book.title, book.author, book.total_chapters, book.views)
# Walk chapters for a known book.
for chapter in client.book(book_id="1205249").chapters(limit=3):
print(chapter.title, chapter.date)
# Get full text of a chapter.
ch = client.book(book_id="1205249").chapters(limit=1).first()
if ch:
try:
full = ch.content()
print(full.title, full.novel_title, len(full.content), "chars")
except ChapterNotFound as e:
print("gone:", e.chapter_id)
print("exercised: book_summaries.list / BookSummary.details / Book.chapters / Chapter.content")
List chapters for a novel, ordered newest-first. Returns 25 chapters per page with metadata including title, date, and direct link. Results are auto-iterated across pages.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for chapter listing (1-based). |
| book_idrequired | string | Numeric book/novel identifier (e.g. 1205249 for Shadow Slave). |
{
"type": "object",
"fields": {
"page": "integer — current page number",
"book_id": "integer — numeric book identifier",
"chapters": "array of chapter objects with id, title, date, link",
"book_title": "string — name of the novel",
"total_pages": "integer — total number of pages",
"total_chapters": "integer — total chapter count"
},
"sample": {
"data": {
"page": 1,
"book_id": 1205249,
"chapters": [
{
"id": "3226204",
"date": "2026-07-22 04:06:57",
"link": "https://ranobes.top/shadow-slave-v741610-1205249/3226204.html",
"title": "Chapter 3114: Missing Core"
}
],
"book_title": "Shadow Slave",
"total_pages": 125,
"total_chapters": 3114
},
"status": "success"
}
}About the Ranobes API
Novel Discovery and Filtering
The get_books endpoint returns 10 novels per page and accepts two optional parameters: genre (e.g. Fantasy, Xianxia, Sci-fi) and order (e.g. rating, date;desc, news_read;desc). Each result object includes id, title, author, cover_image, genres, rating, status, and a direct link. The total_novels field tells you how many results match your filter across all pages. Genre values are case-sensitive.
Chapter Listing and Pagination
The list_chapters endpoint requires a book_id (the numeric identifier visible in a novel's URL) and returns up to 25 chapters per page, ordered newest-first. Each chapter object in the chapters array carries id, title, date, and link. The response also exposes total_pages and total_chapters so you can determine how many pages to iterate. The page parameter is 1-based and optional — omitting it defaults to the first page.
Full Chapter Text
The get_chapter_content endpoint takes a chapter_id sourced from list_chapters results and returns the complete content string for that chapter alongside its title, chapter_id, and novel_title. The book_id parameter is optional but helps resolve the chapter URL. There is no truncation — the full text is returned in a single response field.
Book Metadata
The get_book_info endpoint accepts a book_id and returns a wide set of fields: title, author, cover_image, genres, tags, rating, status, views, link, and book_id. The status field distinguishes between ongoing and completed publications. rating is returned as a string representing an aggregate score out of 5.
The Ranobes API is a managed, monitored endpoint for ranobes.top — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ranobes.top changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ranobes.top API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a personal reading tracker that syncs new chapters via
list_chaptersand storestotal_chaptersover time to detect updates. - Fetch full chapter text with
get_chapter_contentfor offline reading apps or e-reader exports. - Catalog novels by genre using
get_bookswith thegenrefilter to build a curated reading list. - Display novel detail pages using
get_book_infofields: cover image, author, rating, tags, and publication status. - Sort novels by view count or newest additions using the
orderparameter onget_booksto surface trending or recently updated titles. - Compare chapter counts across novels by combining
total_chaptersfromlist_chapterswith metadata fromget_book_info. - Track completed vs. ongoing series using the
statusfield returned byget_book_info.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ranobes.top have an official developer API?+
What does `list_chapters` return, and how does pagination work?+
book_id, each with id, title, date, and link, plus total_pages and total_chapters at the response level. Pages are 1-based; omitting the page parameter returns page 1. Chapters are ordered newest-first.Does `get_book_info` return a novel's description or synopsis?+
get_book_info include title, author, cover_image, genres, tags, rating, status, views, and link, but a full synopsis or description field is not currently exposed in the response schema. You can fork the API on Parse and revise it to surface the description field if it becomes accessible.Is there a way to search novels by title or author name?+
get_books endpoint supports filtering by genre and sorting by order, but title or author name search is not an available parameter. You can fork this API on Parse and revise it to add a search endpoint targeting that functionality.Are there any known limitations with genre filtering in `get_books`?+
genre parameter is case-sensitive and must match the site's exact genre labels (e.g. Sci-fi, not sci-fi or Science Fiction). Passing an unrecognized genre string may return no results or default to an unfiltered listing.