# Novelbin — 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.

> Search and browse novels by title, genre, or popularity, and explore trending, completed, or recently updated works. Access full novel details, chapter listings, chapter content, author information, related titles, and reader comments. Authenticated users can manage bookmarks with reading-status tracking and subscribe to novels for update notifications.

**Category:** Entertainment | **Website:** [novelbin.me/](https://novelbin.me/) | **Docs:** [parse.bot/marketplace/e0f4ccf0-cefd-4a49-9e91-47eb15a5f94f/novelbin-me-api](https://parse.bot/marketplace/e0f4ccf0-cefd-4a49-9e91-47eb15a5f94f/novelbin-me-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Add to bookmark

Add a novel to the authenticated user's bookmark list. Requires prior login call in the same session.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Novel slug |
| `status` | string | No | Status: reading, plan_to_read, completed, dropped |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/add_to_bookmark \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","status":"<string>"}'
```

### Get chapter content

Retrieve the full text content of a specific chapter. The novel_slug and chapter_slug together identify a unique chapter page. Chapter slugs come from get_novel_chapters results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chapter_slug` | string | Yes | Chapter slug identifier from get_novel_chapters results (e.g. 'chapter-1-nightmare-begins') |
| `novel_slug` | string | Yes | Novel slug identifier (e.g. 'shadow-slave') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_chapter_content \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chapter_slug":"<string>","novel_slug":"<string>"}'
```

### Get completed novels

Retrieve novels marked as fully completed, paginated. Returns 20 novels per page with title, slug, author, and cover image.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_completed_novels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get genres list

Return all available genre categories that can be used with get_novels_by_genre. This is a static list and does not require any input.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_genres_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get hot novels

Retrieve currently trending/hot novels, paginated. Returns 20 novels per page with title, slug, author, and cover image.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_hot_novels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get latest release novels

Retrieve the most recently updated novels, paginated. Returns 20 novels per page with title, slug, author, and cover image.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_latest_release_novels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get most popular novels

Retrieve all-time most popular novels sorted by total viewership, paginated. Returns 20 novels per page with title, slug, author, and cover image.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_most_popular_novels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get novel chapters

Retrieve the list of all chapters for a given novel. May return a large list for long novels (thousands of chapters). Each chapter includes a title and slug usable with get_chapter_content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Novel slug identifier (e.g. 'shadow-slave') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_novel_chapters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get novel comments

Retrieve reader comments for a specific novel, with pagination and sort control.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `skip` | integer | No | Number of comments to skip for pagination. |
| `slug` | string | Yes | Novel slug identifier (e.g. 'shadow-slave') |
| `sort` | string | No | Sort order: 'latest' or 'oldest' |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_novel_comments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"skip":"<integer>","slug":"<string>","sort":"<string>"}'
```

### Get novel details

Retrieve full details for a specific novel by its slug, including title, author, genres, status, rating, cover image URL, and description. The slug is the URL-path identifier from search or listing results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Novel slug identifier (e.g. 'shadow-slave', 'lord-of-the-mysteries') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_novel_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get novels by genre

Retrieve novels filtered by a specific genre, paginated. Returns 20 novels per page. Use get_genres_list to see all available genres.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | Yes | Genre name. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_novels_by_genre \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>","page":"<integer>"}'
```

### Get related novels

Retrieve novels related to a given novel (hot novels in the same genre). Returns a list of novel titles and slugs from the novel's detail page sidebar.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Novel slug identifier (e.g. 'shadow-slave') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/get_related_novels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Login

Authenticate a user with email and password.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `email` | string | Yes | User email |
| `password` | string | Yes | User password |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/login \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"<string>","password":"<string>"}'
```

### Search novels

Full-text search over NovelBin's catalog by keyword. Returns matching novels with title, author, cover image, and latest chapter info. Results are not paginated — all matches for the keyword appear in a single response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'shadow slave', 'cultivation') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/search_novels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Subscribe to novel

Subscribe to a novel to receive notifications. Requires prior login call in the same session.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Novel slug |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-novelbin-me-api-e0f4ccf0/subscribe_to_novel \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```