# Tweakers — 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.

> Access product listings, prices, shop comparisons, news articles, and search results from Tweakers.net — the leading Dutch tech platform and price comparison site.

**Category:** E-commerce | **Website:** [tweakers.net/](https://tweakers.net/) | **Docs:** [parse.bot/marketplace/8a867cd3-1b2a-46d7-b7a6-67d883bed23c/tweakers-net-api](https://parse.bot/marketplace/8a867cd3-1b2a-46d7-b7a6-67d883bed23c/tweakers-net-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-tweakers-net-api-8a867cd3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_laptop_product_detail

Get product detail information for a Tweakers Pricewatch product by its numeric ID. Returns the product title, key specifications (GPU, screen size, RAM, CPU, resolution, storage), and a list of shop prices with delivery info. A single-item fetch; no pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | The Tweakers Pricewatch product ID (numeric string, e.g. 2216218). |
| `product_slug` | string | No | The URL slug for the product. Used to construct the product URL; does not affect data returned. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tweakers-net-api-8a867cd3/get_laptop_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","product_slug":"<string>"}'
```

### get_laptops_with_nvidia_gpu

Get products filtered by GPU from Tweakers Pricewatch. Returns product names, specs, prices, and product IDs. Paginated by page number; each page returns up to ~25 products. The gpu_id parameter filters by a specific GPU chip in the Tweakers facet system.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `gpu_id` | string | No | GPU filter ID used in the Tweakers Pricewatch facet system (numeric string). Default 26676 (GeForce RTX 4060). |
| `page` | integer | No | Pagination page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tweakers-net-api-8a867cd3/get_laptops_with_nvidia_gpu \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gpu_id":"<string>","page":"<integer>"}'
```

### get_news_articles

Get news articles for a specific date or the current date. Returns article titles, URLs, author names, and reply counts. Single page per date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYYMMDD format (e.g. 20260611). Defaults to current UTC date. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tweakers-net-api-8a867cd3/get_news_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### get_top_stories

Get the top 10 featured stories from the Tweakers.net homepage. Returns titles, URLs, and reply counts. No pagination; always returns up to 10 items.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tweakers-net-api-8a867cd3/get_top_stories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_webshops

Get a list of all webshops tracked by Tweakers Pricewatch for laptops, including their product counts. No pagination; returns the full list.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tweakers-net-api-8a867cd3/get_webshops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_products

Search for products, articles, and other content on Tweakers.net by keyword. Returns matching items with names, URLs, and category type (Artikel or Product). Single-page result set.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to look for. |

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