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

> Browse free technical books across multiple categories, view detailed book information, and search for specific titles in the FreeBookCentre.net library. Discover learning resources organized by subject with quick access to book details and listings.

**Category:** Education | **Website:** [www.freebookcentre.net/](https://www.freebookcentre.net/) | **Docs:** [parse.bot/marketplace/cc6a6c32-d5a5-47e1-a04c-8db70ceb000d/freebookcentre-net-api](https://parse.bot/marketplace/cc6a6c32-d5a5-47e1-a04c-8db70ceb000d/freebookcentre-net-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-freebookcentre-net-api-cc6a6c32/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_book_details

Get detailed information about a specific book including title, author, full description, page count, breadcrumb navigation showing category hierarchy, and the page URL. The book_path is obtained from the detail_path field in list_books responses.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book_path` | string | Yes | URL path to a book detail page, obtained from detail_path in list_books response (e.g. /ComputerScience-Books-Download/Concurrent-Programming-in-ERLANG.html). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-freebookcentre-net-api-cc6a6c32/get_book_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"book_path":"<string>"}'
```

### list_books

List books from a specific category or subcategory page. Returns book titles, authors, descriptions, page counts, and detail paths. Also returns subcategories if present on the page. The category_path is obtained from list_categories or from the subcategories array in a previous list_books response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | URL path to a category or subcategory page, obtained from list_categories or from subcategories in a previous list_books response (e.g. /CompuScience/free-computer-algorithm-books.html). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-freebookcentre-net-api-cc6a6c32/list_books \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_path":"<string>"}'
```

### list_categories

List all main book categories available on the site. Returns category names and their URL paths for use with the list_books endpoint. Each category path can be passed to list_books to retrieve its book listings and subcategories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-freebookcentre-net-api-cc6a6c32/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_books

Search for books and categories by keyword. Searches the homepage content for matching category names and book titles. Returns matching categories (with paths usable in list_books) and any matching books found on the homepage. The search is case-insensitive and matches against both category/link names and book title/description text.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against category names and book titles (e.g. 'python', 'algorithms', 'physics'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-freebookcentre-net-api-cc6a6c32/search_books \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```