# Coolblue Belgium — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse electronics products from Coolblue Belgium, including CPUs, GPUs, and smartphones, with instant access to detailed specifications, pricing, and availability. Find exactly what you need by category or search query, and check real-time stock and price information across their entire catalog.

**Category:** E-commerce | **Website:** [coolblue.be/](https://coolblue.be/) | **Docs:** [parse.bot/marketplace/2bba05e1-68fc-4bed-8eae-02f8613776d7/coolblue-be-api](https://parse.bot/marketplace/2bba05e1-68fc-4bed-8eae-02f8613776d7/coolblue-be-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-coolblue-be-api-2bba05e1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_listings

Retrieve product listings for a specific category by URL path segment. Returns paginated results with product details. Category paths mirror the site URL structure (e.g. 'smartphones', 'videokaarten', 'laptops/windows-laptops').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | Category URL path segment (e.g. 'smartphones', 'videokaarten', 'processoren', 'laptops/windows-laptops') |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-be-api-2bba05e1/get_category_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_path":"<string>","page":"<integer>"}'
```

### get_cpu_listings

Retrieve CPU (processoren) product listings from Coolblue.be. Returns paginated results with product name, price, availability, and image. Equivalent to get_category_listings with category_path='processoren'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-be-api-2bba05e1/get_cpu_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_gpu_listings

Retrieve GPU (videokaarten) product listings from Coolblue.be. Returns paginated results with product name, price, availability, and image. Equivalent to get_category_listings with category_path='videokaarten'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-be-api-2bba05e1/get_gpu_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_product_details

Get full product detail page including specifications, price, rating, description, and metadata for any product by its URL. Extracts structured data from JSON-LD and HTML specification tables. Returns comprehensive product information suitable for comparison or monitoring.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Full product URL or path (e.g. 'https://www.coolblue.be/nl/product/957550/amd-ryzen-7-9800x3d.html') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-be-api-2bba05e1/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"<string>"}'
```

### get_product_price_and_availability

Retrieve current price and availability for a specific product. Returns a subset of product details focused on pricing and stock status. Useful for monitoring price changes without fetching the full specification set.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Full product URL or path (e.g. 'https://www.coolblue.be/nl/product/935188/apple-iphone-15-128gb-zwart.html') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-be-api-2bba05e1/get_product_price_and_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"<string>"}'
```

### get_smartphone_listings

Retrieve smartphone product listings from Coolblue.be. Returns paginated results with product name, price, availability, and image. Equivalent to get_category_listings with category_path='smartphones'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-be-api-2bba05e1/get_smartphone_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_products

Full-text search across Coolblue.be's product catalog. Returns products matching the query keyword with name, price, availability, and product ID. Handles search redirects to brand or category pages automatically. Results are returned as a single page of all matching items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'iPhone', 'headphones', 'monitor') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-be-api-2bba05e1/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```