# La Feltrinelli — 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 search La Feltrinelli's complete book catalog to discover new releases, bestsellers, preorders, and discounted titles across all categories with detailed book information. Filter by publication date, price, popularity, and custom criteria to find exactly what you're looking for.

**Category:** E-commerce | **Website:** [lafeltrinelli.it/](https://lafeltrinelli.it/) | **Docs:** [parse.bot/marketplace/22ba7a3e-baf7-4e6e-958d-a81d7aed67db/lafeltrinelli-it-api](https://parse.bot/marketplace/22ba7a3e-baf7-4e6e-958d-a81d7aed67db/lafeltrinelli-it-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/la-feltrinelli/`
**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

### Advanced search books

Advanced search for books by title and/or author on La Feltrinelli. At least one of title or author must be provided. Results are filtered to books only (Libri). Pagination is 1-based.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `author` | string | No | Author name to search for |
| `page` | integer | No | Page number (1-based) |
| `title` | string | No | Book title to search for |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/la-feltrinelli/advanced-search-books \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"author":"<string>","page":"<integer>","title":"<string>"}'
```

### Get bestsellers

Fetches the bestseller chart from La Feltrinelli by parsing the rankings page. Returns an array of ranked books with position. Chart data is scraped from HTML so price info may be absent for some entries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug for the chart |
| `time_period` | string | No | Time period for the chart |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/la-feltrinelli/get-bestsellers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","time_period":"<string>"}'
```

### Get book details

Fetches full details for a specific book by its EAN (13-digit ISBN) or product URL. At least one of ean or url must be provided. The URL must contain the /e/<ean> pattern.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ean` | string | No | Book EAN (13-digit ISBN) |
| `url` | string | No | Product URL on lafeltrinelli.it containing /e/<ean> pattern |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/la-feltrinelli/get-book-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"ean":"<string>","url":"<string>"}'
```

### Get books by category

Fetches books filtered by department/category name on La Feltrinelli. Returns paginated results. Category names are Italian department labels as used on the site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category name as used on the site (e.g. Narrativa italiana, Narrativa straniera, Gialli, thriller, horror, Fantasy e fantascienza) |
| `limit` | integer | No | Max results per page |
| `page` | integer | No | Page number (0-based) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/la-feltrinelli/get-books-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>","page":"<integer>"}'
```

### Get discounted books

Fetches discounted books from La Feltrinelli filtered by promotion type. Returns paginated results filtered by the offers facet.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page |
| `page` | integer | No | Page number (0-based) |
| `type` | string | No | Filter type for discounts |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/la-feltrinelli/get-discounted-books \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","type":"<string>"}'
```

### Get new books last 30 days

Fetches new book releases from the last 30 days on La Feltrinelli. Returns paginated results with book metadata. Pagination is 0-based.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page |
| `page` | integer | No | Page number (0-based) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/la-feltrinelli/get-new-books-last-30-days \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get new books last 90 days

Fetches new book releases from the last 90 days on La Feltrinelli. Returns paginated results with book metadata. Pagination is 0-based.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page |
| `page` | integer | No | Page number (0-based) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/la-feltrinelli/get-new-books-last-90-days \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get new books this week

Fetches new book releases from the last week on La Feltrinelli. Returns paginated results with book metadata including title, author, publisher, year, category, price, and availability. Pagination is 0-based. Each result includes an EAN usable with get_book_details for full info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page |
| `page` | integer | No | Page number (0-based) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/la-feltrinelli/get-new-books-this-week \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get preorder books

Fetches books available for pre-order on La Feltrinelli. Returns paginated results of upcoming releases with availability status 'In prenotazione'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page |
| `page` | integer | No | Page number (0-based) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/la-feltrinelli/get-preorder-books \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Search books

Full-text keyword search across the La Feltrinelli catalog. Returns paginated results across all product types. Pagination is 0-based. Results include EAN for detail lookups.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page |
| `page` | integer | No | Page number (0-based) |
| `query` | string | Yes | Search keyword |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/la-feltrinelli/search-books \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

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