# Megekko (Belgium) — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/megekko-belgium/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/megekko-belgium/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/megekko-belgium/list-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/megekko-belgium/list-cpu-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/megekko-belgium/list-gpu-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/megekko-belgium/list-products-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/megekko-belgium/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.