# Kiabi Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/kiabi/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/kiabi-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 fashion product details from Kiabi by URL or reference: price, sizes, colors, fabric composition, 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/kiabi/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Product lookup by reference 46898

```json
{
  "id": "KI-46898-00",
  "price": "19,99 €",
  "title": "Jean slim stretch homme bleu délavé",
  "colors": [
    {
      "name": "Bleu délavé",
      "hex_code": "#7B9EBC",
      "thumbnail_url": "https://static.kiabi.com/images/jean-slim-stretch-homme-bleu-delave-46898_1_fr1.jpg"
    },
    {
      "name": "Noir",
      "hex_code": "#1C1C1C",
      "thumbnail_url": "https://static.kiabi.com/images/jean-slim-stretch-homme-noir-46898_2_fr1.jpg"
    },
    {
      "name": "Gris anthracite",
      "hex_code": "#4A4A4A",
      "thumbnail_url": "https://static.kiabi.com/images/jean-slim-stretch-homme-gris-46898_3_fr1.jpg"
    }
  ],
  "rating": 4.4,
  "category": "Jeans",
  "currency": "EUR",
  "universe": "Homme",
  "reference": "46898",
  "breadcrumb": [
    "Homme",
    "Jeans",
    "Jeans slim"
  ],
  "image_urls": [
    "https://static.kiabi.com/images/jean-slim-stretch-homme-bleu-delave-46898_1_fr1.jpg",
    "https://static.kiabi.com/images/jean-slim-stretch-homme-bleu-delave-46898_2_fr1.jpg",
    "https://static.kiabi.com/images/jean-slim-stretch-homme-bleu-delave-46898_3_fr1.jpg"
  ],
  "description": "Le jean slim stretch Kiabi offre un confort optimal grâce à sa coupe ajustée et son tissu légèrement élasthané. Parfait pour un look casual ou smart-casual.",
  "price_float": 19.99,
  "product_url": "https://www.kiabi.com/jean-slim-stretch-homme-bleu-delave_46898.html",
  "availability": "in_stock",
  "is_promotion": true,
  "sub_category": "Jeans slim",
  "reviews_count": 312,
  "thumbnail_url": "https://static.kiabi.com/images/jean-slim-stretch-homme-bleu-delave-46898_1_fr1.jpg",
  "delivery_delay": "Livraison en 3-5 jours ouvrés",
  "original_price": "24,99 €",
  "size_guide_url": "https://www.kiabi.com/guide-des-tailles-homme",
  "available_sizes": [
    "XS",
    "S",
    "M",
    "L",
    "XL",
    "XXL",
    "3XL"
  ],
  "promotion_label": "-20%",
  "care_instructions": [
    "Lavage en machine à 30°C",
    "Ne pas utiliser de sèche-linge",
    "Repassage à basse température",
    "Ne pas blanchir"
  ],
  "delivery_available": true,
  "fabric_composition": "98% Coton, 2% Élasthanne",
  "in_store_available": true,
  "discount_percentage": 20,
  "rating_distribution": {
    "1": 4,
    "2": 7,
    "3": 18,
    "4": 62,
    "5": 221
  },
  "original_price_float": 24.99
}
```

## Documentation

## Overview
The Kiabi Product API extracts the complete data sheet for any clothing item on kiabi.com using a reference code or product URL.

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

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product reference code or full Kiabi product URL |
| `country` | string | no | Storefront country code (default `fr`) |

## Notes
- Returns `null` if the product is not found
- `colors` includes hex codes for colour-based filtering

## Main use cases
- Enrich fashion product databases with complete Kiabi data
- Monitor clothing prices and promotions for pricing intelligence
- Extract size availability data to track inventory patterns
- Build colour-aware recommendation engines
- Verify product data across multiple Kiabi storefronts