# King Jouet Search

## Overview

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

## 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

Search King Jouet products and retrieve real-time prices, age ratings, availability, and promotions from France's leading toy retailer.

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

## Example Response

### Search 'lego star wars'

```json
{
  "meta": {
    "query": "lego star wars",
    "total_pages": 8,
    "current_page": 1,
    "has_next_page": true,
    "total_results": 187
  },
  "results": [
    {
      "id": "75375",
      "brand": "LEGO",
      "price": "169,99 €",
      "title": "LEGO Star Wars 75375 - Le Faucon Millenium",
      "rating": 4.8,
      "age_max": null,
      "age_min": 9,
      "category": "Jeux de construction",
      "currency": "EUR",
      "reference": "LEG75375",
      "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",
      "original_price": "199,99 €",
      "discount_percentage": 15
    },
    {
      "id": "75368",
      "brand": "LEGO",
      "price": "39,99 €",
      "title": "LEGO Star Wars 75368 - Le Robot Dark Vador",
      "rating": 4.6,
      "age_max": null,
      "age_min": 8,
      "category": "Jeux de construction",
      "currency": "EUR",
      "reference": "LEG75368",
      "price_float": 39.99,
      "product_url": "https://www.kingjouet.fr/p/lego-star-wars-75368-le-robot-dark-vador/LEG75368",
      "availability": "in_stock",
      "is_promotion": false,
      "sub_category": "LEGO Star Wars",
      "reviews_count": 218,
      "thumbnail_url": "https://media.kingjouet.fr/media/catalog/product/cache/600x600/l/e/lego-75368-robot-dark-vador.jpg",
      "original_price": null,
      "discount_percentage": null
    },
    {
      "id": "75379",
      "brand": "LEGO",
      "price": "89,99 €",
      "title": "LEGO Star Wars 75379 - R2-D2",
      "rating": 4.9,
      "age_max": null,
      "age_min": 10,
      "category": "Jeux de construction",
      "currency": "EUR",
      "reference": "LEG75379",
      "price_float": 89.99,
      "product_url": "https://www.kingjouet.fr/p/lego-star-wars-75379-r2-d2/LEG75379",
      "availability": "in_stock",
      "is_promotion": true,
      "sub_category": "LEGO Star Wars",
      "reviews_count": 501,
      "thumbnail_url": "https://media.kingjouet.fr/media/catalog/product/cache/600x600/l/e/lego-75379-r2d2.jpg",
      "original_price": "99,99 €",
      "discount_percentage": 10
    }
  ]
}
```

## Documentation

## Overview
The King Jouet Search API gives you structured access to the full product catalogue of King Jouet, France's largest independent toy retailer. Query any keyword and retrieve product names, live prices, promotions, stock availability, customer ratings, age recommendations, and direct URLs.

## Quickstart
```
GET https://api.piloterr.com/v2/kingjouet/search?query=lego+star+wars
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword, product name, brand, or reference |
| `page` | integer | no | Page number (default 1) |
| `max_results` | integer | no | Results per page (max 48, default 24) |
| `category` | string | no | Category filter (e.g. `jeux-construction`) |
| `age` | string | no | Age range: `0-2`, `3-5`, `6-8`, `9-11`, `12+` |

## Notes
- Promoted products include both `price` and `original_price`
- Use `age` to filter results for specific audience groups

## Main use cases
- Monitor toy prices and seasonal promotions on King Jouet for procurement decisions
- Build automated price-tracking dashboards for major toy brands
- Analyse pricing trends in the French toy market for competitor intelligence
- Identify best-sellers in specific age ranges for product recommendation engines
- Collect structured catalogue data for retail analytics and demand forecasting