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

> 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.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.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.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.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.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.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.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.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.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.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.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.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.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.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.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.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>"}'
```