# Books Toscrape — 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 and filter thousands of books by category with easy pagination, then dive into detailed information like pricing, availability, and ratings for any book that interests you. Quickly find the perfect book from the complete catalog without hassle.

**Category:** E-commerce | **Website:** [books.toscrape.com/](https://books.toscrape.com/) | **Docs:** [parse.bot/marketplace/bb76cc43-d770-415a-aa9f-e8883af4cfee/books-toscrape-com-api](https://parse.bot/marketplace/bb76cc43-d770-415a-aa9f-e8883af4cfee/books-toscrape-com-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-books-toscrape-com-api-bb76cc43/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_book_details

Get full details for a single book by its URL path slug. Returns title, price, rating, availability with stock count, UPC, tax info, description, and category. The book_path is the slug portion from a book's URL (e.g. 'a-light-in-the-attic_1000' from the product page URL).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book_path` | string | Yes | Book URL slug from list_books results (e.g. 'a-light-in-the-attic_1000'). Available in list_books response as books[*].book_path. |

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

### list_books

List books from the catalog with pagination. Optionally filter by category slug. Returns 20 books per page with title, price (GBP), star rating (1-5), availability status, and product page URL. Paginate by incrementing page until has_next_page is false.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug to filter by (e.g. 'travel_2', 'mystery_3', 'historical-fiction_4'). Omit to list all books across categories. |
| `page` | integer | No | Page number (1-based). Each page returns up to 20 books. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-books-toscrape-com-api-bb76cc43/list_books \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```