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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/fnac/`
**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 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/credits/fnac/get-bons-plans \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fnac/get-flash-sales-laptops \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fnac/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fnac/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fnac/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","sort":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.