# Ranobes — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/ranobes/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/ranobes/get-book-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ranobes/get-books \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ranobes/get-chapter-content \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ranobes/list-chapters \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"book_id":"<string>","page":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.