# Amazon (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 Amazon Belgium with sorting and price filters, view detailed product information by ASIN, and get autocomplete suggestions to refine your searches. Find exactly what you're looking for with real-time product availability and pricing data from Amazon.com.be.

**Category:** E-commerce | **Website:** [www.amazon.com.be/](https://www.amazon.com.be/) | **Docs:** [parse.bot/marketplace/eda0f1ca-d659-48c7-ab8c-1be6a76ebffd/amazon-com-be-api](https://parse.bot/marketplace/eda0f1ca-d659-48c7-ab8c-1be6a76ebffd/amazon-com-be-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/amazon-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

Get detailed information about a specific product by its ASIN. Returns title, price, rating, review count, brand, feature bullets, availability, description, and image URLs. The ASIN is an alphanumeric product identifier obtained from search_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (e.g. 'B0BTJD6LCL'). Alphanumeric product identifier from search_products results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/amazon-belgium/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asin":"<string>"}'
```

### Get search suggestions

Get autocomplete search suggestions for a given prefix. Returns up to 10 keyword suggestions as the user types in the search bar. Useful for discovering popular search terms and refining queries before executing a full search.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `prefix` | string | Yes | Partial search query to get suggestions for (e.g. 'laptop', 'wireless head'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/amazon-belgium/get-search-suggestions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"prefix":"<string>"}'
```

### Search products

Search for products on Amazon Belgium. Returns paginated results with product details including price, rating, and review count. Supports sorting by relevance, price, customer reviews, newest arrivals, and best sellers. Supports price range filtering in EUR. Results are locale-dependent and may appear in Dutch, French, or English.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_price` | string | No | Maximum price filter in EUR. Numeric value as string (e.g. '50' for €50). |
| `min_price` | string | No | Minimum price filter in EUR. Numeric value as string (e.g. '20' for €20). |
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | Yes | Search query string (e.g. 'wireless headphones', 'laptop'). |
| `sort` | string | No | Sort order for search results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/amazon-belgium/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"max_price":"<string>","min_price":"<string>","page":"<integer>","query":"<string>","sort":"<string>"}'
```

## Next steps

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