# Fnac Product

## Overview

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

## Description

Extract full product details from Fnac by URL, product ID, or EAN: price, technical specs, marketplace offers, ratings, and availability.

## 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/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Product lookup by ID a18180455

```json
{
  "id": "a18180455",
  "ean": "4548736132306",
  "brand": "Sony",
  "price": "299,00 €",
  "title": "Sony WH-1000XM5 - Casque Bluetooth à réduction de bruit - Noir",
  "offers": [
    {
      "price": "299,00 €",
      "seller": "Fnac",
      "condition": "Neuf",
      "availability": "in_stock",
      "seller_rating": null
    },
    {
      "price": "284,99 €",
      "seller": "AudioMarket",
      "condition": "Neuf",
      "availability": "in_stock",
      "seller_rating": 4.5
    },
    {
      "price": "219,00 €",
      "seller": "Occasion Premium",
      "condition": "Très bon état",
      "availability": "in_stock",
      "seller_rating": 4.8
    }
  ],
  "rating": 4.7,
  "category": "Son",
  "currency": "EUR",
  "breadcrumb": [
    "Son",
    "Casques audio",
    "Casques à réduction de bruit"
  ],
  "image_urls": [
    "https://static.fnac-static.com/multimedia/Images/FR/NR/c3/56/18/1594051/1507-3.jpg",
    "https://static.fnac-static.com/multimedia/Images/FR/NR/c3/56/18/1594051/1507-4.jpg",
    "https://static.fnac-static.com/multimedia/Images/FR/NR/c3/56/18/1594051/1507-5.jpg"
  ],
  "description": "Le casque Sony WH-1000XM5 établit un nouveau standard en matière de réduction de bruit active. Grâce à 8 microphones et 2 processeurs dédiés, il offre une isolation phonique exceptionnelle avec 30 heures d'autonomie.",
  "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,
  "offers_count": 8,
  "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",
  "adherent_price": "284,05 €",
  "delivery_delay": "Livraison en 24h",
  "original_price": "380,00 €",
  "promotion_label": "-21%",
  "technical_specs": {
    "Type": "Casque supra-auriculaire",
    "Poids": "250 g",
    "Couleur": "Noir",
    "Autonomie": "30 heures",
    "Codec audio": "SBC, AAC, LDAC",
    "Microphones": "8 microphones",
    "Charge rapide": "3 min = 3 heures",
    "Connectivité": "Bluetooth 5.2",
    "Réduction de bruit": "Active (ANC)",
    "Référence constructeur": "WH1000XM5B"
  },
  "delivery_available": true,
  "in_store_available": true,
  "discount_percentage": 21,
  "rating_distribution": {
    "1": 20,
    "2": 34,
    "3": 97,
    "4": 368,
    "5": 1324
  },
  "original_price_float": 380,
  "is_adherent_price_available": true
}
```

## Documentation

## Overview
The Fnac Product API extracts the complete data sheet for any Fnac product using a product ID, EAN barcode, or URL.

## Quickstart
```
GET https://api.piloterr.com/v2/fnac/product?query=a18180455&country=fr
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Fnac product ID, EAN-13 barcode, or full product URL |
| `country` | string | no | Storefront country code (default `fr`) |

## Notes
- Returns `null` if the product is not found
- `offers` includes all marketplace sellers for price comparison
- `adherent_price` is the Fnac membership discount price

## Main use cases
- Extract all marketplace offers for best-price detection
- Monitor product prices and promotions for electronics intelligence
- Compare Fnac-direct vs. marketplace seller pricing
- Collect EAN-based data for cross-platform product matching
- Build deal aggregation platforms monitoring adherent prices