# Books Toscrape — 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.

> 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/books-toscrape/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/books-toscrape/get-book-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/books-toscrape/list-books \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<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.