# La Feltrinelli — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/advanced_search_books \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/get_bestsellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/get_book_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/get_books_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/get_discounted_books \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/get_new_books_last_30_days \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/get_new_books_last_90_days \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/get_new_books_this_week \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/get_preorder_books \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lafeltrinelli-it-api-22ba7a3e/search_books \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```