# Alternate 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 for products on Alternate Belgium and instantly access live prices, stock availability, technical specifications, customer reviews, and current deals across their entire catalog. Browse their complete category structure to find exactly what you need and compare products before making a purchase decision.

**Category:** E-commerce | **Website:** [alternate.be/](https://alternate.be/) | **Docs:** [parse.bot/marketplace/6a482ed5-b134-4f62-a93a-390c15013dee/alternate-be-api](https://parse.bot/marketplace/6a482ed5-b134-4f62-a93a-390c15013dee/alternate-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-alternate-be-api-6a482ed5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_listings

Get product listings for a category path segment. Leaf categories (e.g. 'Grafische-kaarten') return products with the same shape as search results. Parent categories (e.g. 'Hardware') may return an empty product list. Pagination is 0-indexed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category path segment (e.g. 'Grafische-kaarten', 'Processoren', 'Hardware'). |
| `page` | integer | No | Page number (0-indexed). |

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

### get_category_tree

Get the top-level category tree from the main navigation menu. Returns category names with tree IDs and their immediate subcategories fetched via AJAX navigation.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alternate-be-api-6a482ed5/get_category_tree \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_deals_promotions

Get current deals and promotions from the Acties page. Returns deals organized by section: Nieuwe acties (new), Lopende acties (ongoing), and Recent afgelopen acties (recently ended).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alternate-be-api-6a482ed5/get_deals_promotions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_detail

Get detailed information for a specific product including name, price, availability, grouped technical specifications, and description. Requires the full product URL as returned by search or category listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Full product URL from alternate.be (e.g. 'https://www.alternate.be/MSI/GT-710-2GD3H-LP-grafische-kaart/html/product/1250613'). |

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

### get_product_reviews

Get customer reviews for a product by its numeric ID. Returns ratings, comments, author information, and verification status. The product_id is available from search results or product detail responses.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Numeric product ID from product URL or listing (e.g. '1250613'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-alternate-be-api-6a482ed5/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### search_products

Full-text search across all products on alternate.be. Returns paginated product listings with price, availability, and rating. Pagination is 0-indexed. Each result includes a product_id usable for reviews and a url usable for detail lookup.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-indexed). |
| `query` | string | Yes | Search keyword (e.g. 'nvidia', 'laptop', 'monitor'). |

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