# King Jouet Product

## Overview

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

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.piloterr.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Extract full product details from King Jouet by URL or reference: price, age range, specs, ratings, availability, and promotions.

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

## Example Response

### Product lookup by reference LEG75375

```json
{
  "id": "75375",
  "ean": "5702017421513",
  "brand": "LEGO",
  "color": "Gris / Multicolore",
  "price": "169,99 €",
  "title": "LEGO Star Wars 75375 - Le Faucon Millenium",
  "gender": "unisex",
  "rating": 4.8,
  "weight": "1.8 kg",
  "age_max": null,
  "age_min": 9,
  "category": "Jeux de construction",
  "currency": "EUR",
  "features": [
    "1 363 pièces",
    "5 minifigurines incluses : Han Solo, Chewbacca, Princesse Leia, Lando Calrissian, C-3PO",
    "Cockpit ouvrable avec espace intérieur détaillé",
    "Tourelles rotatives supérieure et inférieure",
    "Compatible avec tous les sets LEGO Star Wars"
  ],
  "material": "Plastique ABS",
  "age_label": "Dès 9 ans",
  "reference": "LEG75375",
  "breadcrumb": [
    "Jeux de construction",
    "LEGO",
    "LEGO Star Wars"
  ],
  "dimensions": {
    "width": "36 cm",
    "height": "18 cm",
    "length": "54 cm"
  },
  "image_urls": [
    "https://media.kingjouet.fr/media/catalog/product/cache/1200x1200/l/e/lego-75375-1.jpg",
    "https://media.kingjouet.fr/media/catalog/product/cache/1200x1200/l/e/lego-75375-2.jpg",
    "https://media.kingjouet.fr/media/catalog/product/cache/1200x1200/l/e/lego-75375-3.jpg"
  ],
  "description": "Le Faucon Millenium est l'un des vaisseaux les plus emblématiques de la galaxie Star Wars. Ce set LEGO comprend 1 363 pièces pour construire une réplique ultra-détaillée du vaisseau de Han Solo, avec cockpit ouvrable, tourelles mobiles et minifigurines exclusives.",
  "piece_count": 1363,
  "price_float": 169.99,
  "product_url": "https://www.kingjouet.fr/p/lego-star-wars-75375-le-faucon-millenium/LEG75375",
  "availability": "in_stock",
  "is_promotion": true,
  "sub_category": "LEGO Star Wars",
  "reviews_count": 342,
  "thumbnail_url": "https://media.kingjouet.fr/media/catalog/product/cache/600x600/l/e/lego-75375-faucon-millenium.jpg",
  "delivery_delay": "Livraison en 2-3 jours ouvrés",
  "original_price": "199,99 €",
  "promotion_label": "-15%",
  "delivery_available": true,
  "in_store_available": true,
  "discount_percentage": 15,
  "rating_distribution": {
    "1": 2,
    "2": 4,
    "3": 10,
    "4": 48,
    "5": 278
  },
  "original_price_float": 199.99
}
```

## Documentation

## Overview
The King Jouet Product API extracts the complete data sheet for any product on kingjouet.fr using a reference code or product URL.

## Quickstart
```
GET https://api.piloterr.com/v2/kingjouet/product?query=LEG75375
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product reference code or full King Jouet product URL |

## Notes
- Returns `null` if the product is not found
- `piece_count` is populated only for construction sets

## Main use cases
- Enrich product databases with complete King Jouet data including age ranges and features
- Monitor price changes and promotion activations on individual toy products
- Build gift recommendation tools using age ranges, ratings, and availability
- Verify EAN barcodes for cross-platform product matching
- Track stock levels and delivery options for inventory management