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

> Search for electronics and cultural products on Fnac while accessing detailed product information, customer reviews, current deals, and flash sales all in one place. Get comprehensive insights including pricing, specifications, and promotional offers to make informed shopping decisions.

**Category:** E-commerce | **Website:** [fnac.com/](https://fnac.com/) | **Docs:** [parse.bot/marketplace/14aa0a01-515c-459e-8bdc-c8a8b801d317/fnac-com-api](https://parse.bot/marketplace/14aa0a01-515c-459e-8bdc-c8a8b801d317/fnac-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-fnac-com-api-14aa0a01/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_bons_plans

Retrieve current 'Bons Plans' (good deals) from Fnac across tech categories such as smartphones, headphones, and tablets. Returns products with active promotions or discounts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fnac-com-api-14aa0a01/get_bons_plans \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_flash_sales_laptops

Retrieve laptop products currently featured in Fnac flash sales or promotions. Searches for 15-17 inch laptops with the promotions filter active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fnac-com-api-14aa0a01/get_flash_sales_laptops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_details

Retrieve full details for a specific Fnac product given its URL. Extracts structured data from JSON-LD and page HTML including numeric price, specs, aggregate rating, and full description. The URL must be a valid Fnac product page URL containing '/a<product_id>/'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full Fnac product page URL (e.g. 'https://www.fnac.com/<product-slug>/a<product-id>/w-4') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fnac-com-api-14aa0a01/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_product_reviews

Retrieve customer reviews for a given Fnac product. Navigates to the product's /avis page and extracts individual reviews with ratings, author info, and review text. Returns up to ~10 most recent reviews from the first page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full Fnac product page URL (e.g. 'https://www.fnac.com/<product-slug>/a<product-id>/w-4') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fnac-com-api-14aa0a01/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### search_products

Full-text search across Fnac's product catalog. Returns a paginated list of product summaries matching the query, with prices, ratings, availability, and optional discount info. Results can be sorted by relevance, price ascending, or price descending. Each page returns up to ~20 products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based) |
| `query` | string | Yes | Search keyword (e.g. 'iphone', 'ordinateur portable') |
| `sort` | integer | No | Sort order |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fnac-com-api-14aa0a01/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","sort":"<integer>"}'
```