# Megekko (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 the full Megekko product catalog, view detailed specs, pricing, and stock availability. Browse by category, use keyword search to find specific products, or explore shortcut endpoints for popular categories like GPUs and CPUs.

**Category:** E-commerce | **Website:** [megekko.be/](https://megekko.be/) | **Docs:** [parse.bot/marketplace/4f42cfd9-b25f-4ec0-a74a-dacb7ebf3a63/megekko-be-api](https://parse.bot/marketplace/4f42cfd9-b25f-4ec0-a74a-dacb7ebf3a63/megekko-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-megekko-be-api-4f42cfd9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Fetch full details for a single product by its article number or full URL. Returns comprehensive information including specifications, pricing, availability, images, and delivery info. At least one of product_id or product_url must be provided. When a product does not exist, returns input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | No | Product article number (e.g. '297161'). Use IDs from search_products or list_products_by_category results. |
| `product_url` | string | No | Full product URL (e.g. 'https://www.megekko.nl/product/1963/297161/Nvidia-Videokaarten/Gigabyte-GeForce-RTX-5070-WINDFORCE-OC-12G-Videokaart'). |

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

### list_categories

List all product categories available on Megekko by extracting category links from the homepage navigation. Returns a flat list of category names and paths that can be passed to list_products_by_category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-megekko-be-api-4f42cfd9/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_cpu_products

List CPU (processor) products from the Processoren category, sorted by popularity. Returns subcategory breakdown by socket type. A convenience shortcut for list_products_by_category with the CPU category path.

**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-megekko-be-api-4f42cfd9/list_cpu_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### list_gpu_products

List GPU (video card) products from the Videokaarten category, sorted by popularity. Returns subcategory breakdown (Nvidia, AMD, Workstation). A convenience shortcut for list_products_by_category with the GPU category path.

**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-megekko-be-api-4f42cfd9/list_gpu_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### list_products_by_category

List products in a specific category path. For parent categories with subcategories, automatically fetches products from the largest subcategory and includes the subcategory list in the response. Paginates server-side with up to 50 products per page. Supports filter strings from URL parameters for sorting and filtering.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | Category path starting with / (e.g. '/Computer/Componenten/Videokaarten' or '/Computer/Componenten/Videokaarten/Nvidia-Videokaarten'). Use paths from list_categories or subcategories in prior responses. |
| `filters` | string | No | Filter string from URL parameters (e.g. 'f_vrrd-3_s-populair_pp-50'). Omitting uses default popularity sort with 50 results per page. |
| `page` | integer | No | Page number for pagination. |

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

### search_products

Full-text search over Megekko product catalog. Returns product summaries matching the query, ordered by relevance. Paginates server-side; each page returns up to ~50 results. No filters beyond the query string — finer selection is client-side over the returned list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g. 'RTX 5070', 'AMD Ryzen', 'monitor 4k') |

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