# Cool Club Product

## Overview

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

## Description

Extract full Cool Club product details from coolclub.pl by URL or SKU: price in PLN, sizes, age ranges, color, availability, and images.

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

## Example Response

### Lookup by SKU 'iCLCB3212253'

```json
{
  "id": "iCLCB3212253",
  "sku": "CLCB3212253",
  "brand": "Cool Club",
  "color": "czerwony",
  "price": "29,99 zł",
  "title": "Cool Club, T-shirt chłopięcy, czerwony, Garfield",
  "gender": "Chłopiec",
  "rating": 4.5,
  "item_id": "i8091451",
  "license": "Garfield",
  "category": "Ubrania i buty",
  "currency": "PLN",
  "all_sizes": [
    "104",
    "110",
    "116",
    "122",
    "128",
    "134",
    "140",
    "146",
    "152",
    "158"
  ],
  "set_count": 1,
  "age_ranges": [
    "6-8 lat",
    "9-12 lat"
  ],
  "breadcrumb": [
    "Strona główna",
    "Marka",
    "Cool Club",
    "T-shirty",
    "Chłopiec"
  ],
  "image_urls": [
    "https://www.coolclub.pl/medias/img-800w/CLCB3212253-1-0-01.jpg",
    "https://www.coolclub.pl/medias/img-800w/CLCB3212253-1-0-02.jpg",
    "https://www.coolclub.pl/medias/img-800w/CLCB3212253-1-0-03.jpg"
  ],
  "composition": "100% bawełna",
  "description": "T-shirt chłopięcy z nadrukiem Garfielda. Wykonany z miękkiej, oddychającej bawełny. Krótki rękaw, okrągły dekolt. Idealny na codzień i do szkoły.",
  "price_float": 29.99,
  "product_url": "https://www.coolclub.pl/p/cool-club-t-shirt-chlopiecy-czerwony-garfield-iCLCB3212253/i8091451",
  "availability": "in_stock",
  "is_promotion": true,
  "sub_category": "T-shirty",
  "is_bestseller": true,
  "reviews_count": 312,
  "thumbnail_url": "https://www.coolclub.pl/medias/img-160w/CLCB3212253-1-0-01.jpg",
  "original_price": "42,00 zł",
  "available_sizes": [
    "110",
    "116",
    "122",
    "128",
    "134",
    "140",
    "146"
  ],
  "discount_percent": 29,
  "lowest_price_30d": "29,99 zł",
  "care_instructions": [
    "Prać w 30°C",
    "Nie wybielać",
    "Nie suszyć w bębnie",
    "Prasować w niskiej temperaturze"
  ],
  "available_in_hours": 12,
  "original_price_float": 42
}
```

## Documentation

## Overview
The Cool Club Product API retrieves a complete, structured product data sheet from any Cool Club listing on coolclub.pl in a single API call. Pass a product URL or SKU and receive pricing in PLN, discount percentage, lowest 30-day price, sizes, age ranges, fabric composition, licensed character info, and high-resolution images.

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

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Cool Club product URL or SKU |

## Response fields
| Field | Type | Description |
|---|---|---|
| `price` | string | Current price in PLN |
| `discount_percent` | number | Percentage discount if active |
| `lowest_price_30d` | string | Lowest 30-day pre-promotion price |
| `available_sizes` | array | Sizes in stock |
| `age_ranges` | array | Applicable age ranges |
| `composition` | string | Fabric composition |
| `license` | string | Licensed character if applicable |

## Notes
- Both product URL and SKU are accepted
- Not charged for requests that return no product
- `lowest_price_30d` complies with Polish Omnibus Directive

## Main use cases
- Populate Polish children's fashion databases with real-time Cool Club data
- Track pricing and promotions for specific SKUs in PLN
- Monitor licensed character availability for restock alerts
- Build children's clothing comparison tools with size data
- Analyze bestseller and discount patterns for merchandising strategy