# Fnac Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/fnac/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/fnac-search |

## Description

Search Fnac products and retrieve real-time prices, ratings, availability, seller info, and promotions across electronics, books, gaming, and more.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/fnac/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'sony wh-1000xm5' in France

```json
{
  "meta": {
    "query": "sony wh-1000xm5",
    "country": "fr",
    "total_pages": 2,
    "current_page": 1,
    "has_next_page": true,
    "total_results": 24
  },
  "results": [
    {
      "id": "a18180455",
      "ean": "4548736132306",
      "brand": "Sony",
      "price": "299,00 €",
      "title": "Sony WH-1000XM5 - Casque Bluetooth à réduction de bruit - Noir",
      "rating": 4.7,
      "seller": "Fnac",
      "category": "Son",
      "currency": "EUR",
      "price_float": 299,
      "product_url": "https://www.fnac.com/a18180455/Sony-WH-1000XM5-Casque-Bluetooth-a-reduction-de-bruit-Noir",
      "availability": "in_stock",
      "is_fnac_sold": true,
      "is_promotion": true,
      "sub_category": "Casques audio",
      "reviews_count": 1843,
      "thumbnail_url": "https://static.fnac-static.com/multimedia/Images/FR/NR/c3/56/18/1594051/1507-1.jpg",
      "original_price": "380,00 €",
      "discount_percentage": 21
    },
    {
      "id": "a18180456",
      "ean": "4548736132313",
      "brand": "Sony",
      "price": "299,00 €",
      "title": "Sony WH-1000XM5 - Casque Bluetooth à réduction de bruit - Argent",
      "rating": 4.7,
      "seller": "Fnac",
      "category": "Son",
      "currency": "EUR",
      "price_float": 299,
      "product_url": "https://www.fnac.com/a18180456/Sony-WH-1000XM5-Casque-Bluetooth-a-reduction-de-bruit-Argent",
      "availability": "in_stock",
      "is_fnac_sold": true,
      "is_promotion": true,
      "sub_category": "Casques audio",
      "reviews_count": 1843,
      "thumbnail_url": "https://static.fnac-static.com/multimedia/Images/FR/NR/c4/56/18/1594052/1507-1.jpg",
      "original_price": "380,00 €",
      "discount_percentage": 21
    },
    {
      "id": "a14598231",
      "ean": "4548736121201",
      "brand": "Sony",
      "price": "199,00 €",
      "title": "Sony WH-1000XM4 - Casque Bluetooth à réduction de bruit - Noir",
      "rating": 4.8,
      "seller": "Fnac",
      "category": "Son",
      "currency": "EUR",
      "price_float": 199,
      "product_url": "https://www.fnac.com/a14598231/Sony-WH-1000XM4-Casque-Bluetooth-a-reduction-de-bruit-Noir",
      "availability": "in_stock",
      "is_fnac_sold": true,
      "is_promotion": true,
      "sub_category": "Casques audio",
      "reviews_count": 4217,
      "thumbnail_url": "https://static.fnac-static.com/multimedia/Images/FR/NR/01/12/45/4526081/1507-1.jpg",
      "original_price": "280,00 €",
      "discount_percentage": 29
    }
  ]
}
```

## Documentation

## Overview
The Fnac Search API provides structured access to Fnac's full product catalogue across five European storefronts. Search by keyword, ISBN, EAN, or product name to retrieve live prices, promotions, ratings, seller information, and availability.

## Quickstart
```
GET https://api.piloterr.com/v2/fnac/search?query=sony+wh-1000xm5&country=fr
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword, product name, ISBN, or EAN |
| `country` | string | no | Storefront: `fr`, `es`, `pt`, `be`, `ch` |
| `category` | string | no | Category filter |
| `page` | integer | no | Page number (default 1) |
| `max_results` | integer | no | Results per page (max 50) |

## Main use cases
- Monitor electronics prices on Fnac across five European markets
- Track promotional campaigns for retail pricing intelligence
- Build product comparison tools using Fnac's catalogue
- Identify marketplace vs. Fnac-direct listings
- Collect structured data for e-commerce analytics