# Coolblue (Netherlands) — 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.

> Browse and search thousands of laptops on Coolblue.nl to compare specs, prices, and reviews across new, refurbished, and second-hand models filtered by brand and category. Get detailed product information including specifications, pricing, and customer reviews to find the perfect laptop for your needs.

**Category:** E-commerce | **Website:** [coolblue.nl/](https://coolblue.nl/) | **Docs:** [parse.bot/marketplace/cef88cdc-0d44-4898-a851-68cb6f3bb739/coolblue-nl-api](https://parse.bot/marketplace/cef88cdc-0d44-4898-a851-68cb6f3bb739/coolblue-nl-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-nl-api-cef88cdc/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_affordable_second_chance

Retrieve refurbished/second-chance laptop listings. Returns laptops available at reduced prices in like-new or good condition.

**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-nl-api-cef88cdc/get_affordable_second_chance \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_laptop_details

Get detailed specifications for a laptop product. Returns product name and specification key-value pairs when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product ID from listing (e.g. from search_products results[*].product_id) |
| `slug` | string | Yes | Product URL slug (e.g. from search_products results[*].slug) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-nl-api-cef88cdc/get_laptop_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","slug":"<string>"}'
```

### get_laptop_listings_by_brand

Browse laptops by brand. Returns paginated laptop listings filtered by manufacturer.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand name. Accepted values: apple, hp, lenovo, acer, asus, microsoft, msi, samsung |
| `page` | integer | No | Page number for pagination |

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

### get_laptop_listings_by_category

Browse laptop listings by category. Returns paginated product listings for a given laptop sub-category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category path. Accepted values: laptops, windows-laptops, apple-macbook, gaming-laptops, chromebook-models, business-laptops |
| `page` | integer | No | Page number for pagination |

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

### get_laptop_reviews

Retrieve customer reviews for a specific laptop product. Returns individual reviews with ratings, text, pros/cons, and aggregate rating information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Review page number for pagination |
| `product_id` | string | Yes | Product ID (e.g. from search_products results[*].product_id) |
| `slug` | string | Yes | Product URL slug (e.g. from search_products results[*].slug) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-nl-api-cef88cdc/get_laptop_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","product_id":"<string>","slug":"<string>"}'
```

### get_new_laptops

Retrieve laptop listings sorted by newest additions. Returns the most recently added laptops on Coolblue.

**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-nl-api-cef88cdc/get_new_laptops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_laptops

Search specifically for laptops within the laptop category. Returns products with enriched specification highlights like processor, screen size, and OS.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | No | Search keyword within laptops. If omitted, returns all laptops. |
| `sort` | string | No | Sort order. Accepted values: relevance, price_asc, price_desc, newest, rating |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-nl-api-cef88cdc/search_laptops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","sort":"<string>"}'
```

### search_products

Search for products across all categories on Coolblue. Returns paginated product results matching the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword |
| `sort` | string | No | Sort order. Accepted values: relevance, price_asc, price_desc, newest, rating |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coolblue-nl-api-cef88cdc/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","sort":"<string>"}'
```