# Kiabi Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/kiabi/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/kiabi-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 Kiabi fashion products and retrieve real-time prices, sizes, colors, availability, and promotions from Europe's leading budget clothing brand.

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

## Example Response

### Search 'jean slim homme' in France

```json
{
  "meta": {
    "query": "jean slim homme",
    "country": "fr",
    "universe": "homme",
    "total_pages": 2,
    "current_page": 1,
    "has_next_page": true,
    "total_results": 48
  },
  "results": [
    {
      "id": "KI-46898-00",
      "price": "19,99 €",
      "title": "Jean slim stretch homme bleu délavé",
      "rating": 4.4,
      "category": "Jeans",
      "currency": "EUR",
      "universe": "Homme",
      "reference": "46898",
      "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",
      "original_price": "24,99 €",
      "available_sizes": [
        "XS",
        "S",
        "M",
        "L",
        "XL",
        "XXL",
        "3XL"
      ],
      "available_colors": [
        "Bleu délavé",
        "Noir",
        "Gris anthracite"
      ],
      "discount_percentage": 20
    },
    {
      "id": "KI-58312-00",
      "price": "22,99 €",
      "title": "Jean slim homme gris anthracite",
      "rating": 4.2,
      "category": "Jeans",
      "currency": "EUR",
      "universe": "Homme",
      "reference": "58312",
      "price_float": 22.99,
      "product_url": "https://www.kiabi.com/jean-slim-homme-gris-anthracite_58312.html",
      "availability": "in_stock",
      "is_promotion": false,
      "sub_category": "Jeans slim",
      "reviews_count": 187,
      "thumbnail_url": "https://static.kiabi.com/images/jean-slim-homme-gris-anthracite-58312_1_fr1.jpg",
      "original_price": null,
      "available_sizes": [
        "S",
        "M",
        "L",
        "XL",
        "XXL"
      ],
      "available_colors": [
        "Gris anthracite",
        "Bleu marine"
      ],
      "discount_percentage": null
    },
    {
      "id": "KI-63741-00",
      "price": "18,99 €",
      "title": "Jean slim homme noir",
      "rating": 4.3,
      "category": "Jeans",
      "currency": "EUR",
      "universe": "Homme",
      "reference": "63741",
      "price_float": 18.99,
      "product_url": "https://www.kiabi.com/jean-slim-homme-noir_63741.html",
      "availability": "in_stock",
      "is_promotion": false,
      "sub_category": "Jeans slim",
      "reviews_count": 241,
      "thumbnail_url": "https://static.kiabi.com/images/jean-slim-homme-noir-63741_1_fr1.jpg",
      "original_price": null,
      "available_sizes": [
        "XS",
        "S",
        "M",
        "L",
        "XL",
        "XXL",
        "3XL",
        "4XL"
      ],
      "available_colors": [
        "Noir"
      ],
      "discount_percentage": null
    }
  ]
}
```

## Documentation

## Overview
The Kiabi Search API provides structured access to Kiabi's full fashion catalogue across multiple European storefronts. Search by keyword and filter by country, universe, and page to retrieve live prices, promotions, sizes, colours, and availability.

## Quickstart
```
GET https://api.piloterr.com/v2/kiabi/search?query=slim+jeans+men&country=fr
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword or product name |
| `country` | string | no | Storefront: `fr`, `es`, `it`, `pt`, `ma` |
| `universe` | string | no | Filter: `homme`, `femme`, `enfant`, `bebe`, `maternite` |
| `page` | integer | no | Page number (default 1) |
| `max_results` | integer | no | Results per page (max 60) |

## Main use cases
- Monitor Kiabi prices and seasonal promotions for procurement decisions
- Track size availability across Kiabi's extended size range
- Build fashion price comparison tools across European markets
- Identify trending styles and best-sellers per clothing universe
- Collect structured fashion data for retail analytics