# Cool Club Search

## Overview

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

## Description

Search Cool Club children's products on coolclub.pl and retrieve real-time prices, availability, sizes, age ranges, and categories in PLN.

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

## Example Response

### Search 't-shirt chlopiec'

```json
{
  "meta": {
    "query": "t-shirt chlopiec",
    "gender": "chlopiec",
    "age_group": null,
    "total_pages": 24,
    "current_page": 1,
    "has_next_page": true,
    "total_results": 847
  },
  "results": [
    {
      "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",
      "license": "Garfield",
      "category": "Ubrania i buty",
      "currency": "PLN",
      "image_url": "https://www.coolclub.pl/medias/img-160w/CLCB3212253-1-0-01.jpg",
      "age_ranges": [
        "6-8 lat",
        "9-12 lat"
      ],
      "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,
      "original_price": "42,00 zł",
      "available_sizes": [
        "110",
        "116",
        "122",
        "128",
        "134",
        "140",
        "146"
      ],
      "discount_percent": 29
    },
    {
      "id": "iCCCB3211659",
      "sku": "CCCB3211659",
      "brand": "Cool Club",
      "color": "beżowy",
      "price": "14,99 zł",
      "title": "Cool Club, T-shirt chłopięcy, beżowy",
      "gender": "Chłopiec",
      "license": null,
      "category": "Ubrania i buty",
      "currency": "PLN",
      "image_url": "https://www.coolclub.pl/medias/img-160w/CCCB3211659-1-0-01.jpg",
      "age_ranges": [
        "6-8 lat",
        "9-12 lat"
      ],
      "price_float": 14.99,
      "product_url": "https://www.coolclub.pl/p/cool-club-t-shirt-chlopiecy-bezowy-iCCCB3211659/i8154996",
      "availability": "in_stock",
      "is_promotion": false,
      "sub_category": "T-shirty",
      "is_bestseller": true,
      "original_price": null,
      "available_sizes": [
        "104",
        "110",
        "116",
        "122",
        "128",
        "134"
      ],
      "discount_percent": null
    },
    {
      "id": "iCCCB3211667",
      "sku": "CCCB3211667",
      "brand": "Cool Club",
      "color": "biały",
      "price": "19,99 zł",
      "title": "Cool Club, T-shirt chłopięcy, biały",
      "gender": "Chłopiec",
      "license": null,
      "category": "Ubrania i buty",
      "currency": "PLN",
      "image_url": "https://www.coolclub.pl/medias/img-160w/CCCB3211667-1-0-01.jpg",
      "age_ranges": [
        "3-5 lat",
        "6-8 lat"
      ],
      "price_float": 19.99,
      "product_url": "https://www.coolclub.pl/p/cool-club-t-shirt-chlopiecy-bialy-iCCCB3211667/i8155023",
      "availability": "in_stock",
      "is_promotion": false,
      "sub_category": "T-shirty",
      "is_bestseller": true,
      "original_price": null,
      "available_sizes": [
        "92",
        "98",
        "104",
        "110",
        "116",
        "122"
      ],
      "discount_percent": null
    }
  ]
}
```

## Documentation

## Overview
The Cool Club Search API gives you structured access to the full product catalogue of Cool Club, Poland's leading children's clothing brand sold on coolclub.pl. Query any keyword and retrieve prices in PLN, promotions, available sizes, age ranges, gender, and licensed character branding, with gender and age group filtering.

## Quickstart
```
GET https://api.piloterr.com/v2/coolclub/search?query=t-shirt+chlopiec&gender=chlopiec
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword in Polish |
| `gender` | string | no | Gender: `chlopiec`, `dziewczynka`, `niemowle` |
| `age_group` | string | no | Age group (e.g. `6-8 lat`) |
| `page` | integer | no | Page number (default 1) |
| `max_results` | integer | no | Results per page (max 84, default 36) |

## Notes
- All prices in PLN
- Queries work best in Polish
- Product SKUs can be passed to the Cool Club Product API

## Main use cases
- Monitor Cool Club pricing and promotions to benchmark Polish children's fashion market data
- Build automated catalogues for Polish e-commerce comparison platforms or parenting apps
- Track bestseller rankings and licensed character availability for retail buyers
- Collect children's apparel data for size availability monitoring and restock alerts
- Analyze discount frequency across categories for pricing strategy