# Ranobes — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access novel chapter listings and read full chapter text from ranobes.top to stay updated on your favorite stories. Browse through available chapters and retrieve complete content for any novel in the database.

**Category:** Entertainment | **Website:** [ranobes.top/chapters/1205249/](https://ranobes.top/chapters/1205249/) | **Docs:** [parse.bot/marketplace/478d7e92-2c37-495e-9919-d2dbf23e6589/ranobes-top-api](https://parse.bot/marketplace/478d7e92-2c37-495e-9919-d2dbf23e6589/ranobes-top-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ranobes-top-api-478d7e92/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_book_info

Retrieve detailed metadata for a single novel. Returns title, author, cover image, full description, genres, tags, status, rating, chapter count, views, and last-updated timestamp. The book_id is obtained from list_chapters or known externally.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book_id` | string | Yes | Numeric book/novel identifier (e.g. 1205249 for Shadow Slave). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ranobes-top-api-478d7e92/get_book_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"book_id":"<string>"}'
```

### get_books

Browse all novels on the site with optional genre, status, and sort-order filters. Returns 10 novels per page with cover, rating, genres, status, and direct link. Results are auto-iterated across pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | No | Filter by genre name (e.g. Fantasy, Action, Romance, Drama, Sci-fi, Xuanhuan, Xianxia). Case-sensitive, matches site genre vocabulary. |
| `order` | string | No | Sort order for results. Values include: rating, date;desc (newest), date;asc (oldest), news_read;desc (most views), comm_num;desc (most comments), d.chap-num;desc (most chapters), editdate;desc (recently modified). Omit for default site ordering. |
| `page` | integer | No | Page number for results (1-based). |
| `status` | string | No | Filter by publication status in country of origin. Accepted values: Ongoing, Completed, Hiatus, Dropped. Case-sensitive. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ranobes-top-api-478d7e92/get_books \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>","order":"<string>","page":"<integer>","status":"<string>"}'
```

### get_chapter_content

Retrieve the full text content of a specific chapter. The chapter_id is obtained from list_chapters results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book_id` | string | No | Numeric book/novel identifier. Needed to resolve the chapter URL. |
| `chapter_id` | string | Yes | Numeric chapter identifier from list_chapters results (e.g. 3226204). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ranobes-top-api-478d7e92/get_chapter_content \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"book_id":"<string>","chapter_id":"<string>"}'
```

### list_chapters

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book_id` | string | Yes | Numeric book/novel identifier (e.g. 1205249 for Shadow Slave). |
| `page` | integer | No | Page number for chapter listing (1-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ranobes-top-api-478d7e92/list_chapters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"book_id":"<string>","page":"<integer>"}'
```