# Amazon (Germany) — 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 Amazon.de for products, retrieve detailed product information, customer reviews, seller and offer data, bestseller lists, and autocomplete suggestions.

**Category:** E-commerce | **Website:** [amazon.de/](https://amazon.de/) | **Docs:** [parse.bot/marketplace/8603885c-eeaf-4a57-876c-9fe01c8af2a0/amazon-de-api](https://parse.bot/marketplace/8603885c-eeaf-4a57-876c-9fe01c8af2a0/amazon-de-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/amazon-germany/`
**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 bestsellers

Retrieve the current bestsellers list from Amazon.de. Returns ranked items with title, price, rating, and review count. When no category is specified, returns overall top sellers across all categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_node` | string | No | Category node path segment (e.g. 'computers'). Leave empty for overall bestsellers. |

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

### Get product details

Fetch full product details for a single ASIN including title, brand, price, star rating, description from feature bullets, high-resolution images, and technical specifications. Some fields may be null depending on product availability and page structure.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (ASIN). |

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

### Get product reviews

Retrieve customer reviews visible on a product's page. Returns up to ~9 reviews per page with author, rating, title, body, date, and verified-purchase status. Only reviews shown on the product page are extracted (no deep pagination into all reviews).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (ASIN). |
| `page` | integer | No | Page number (currently only page 1 supported as reviews come from product page). |

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

### Get seller info

Extract seller and offer information for a product ASIN. Returns the main offer details including price, shipping origin, seller name, and availability status as shown on the product page buy-box.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (ASIN). |

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

### Get suggestions

Retrieve autocomplete search suggestions from Amazon.de for a given text prefix. Returns up to 10 keyword suggestions. Useful for building search-ahead UIs or discovering popular query variations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `prefix` | string | Yes | Search prefix to get suggestions for. |

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

### Search products

Full-text search over Amazon.de product listings by keyword. Returns a paginated list of product summaries including price, rating, and Prime eligibility. Advances via integer page counter. Each result carries an ASIN usable for detail/review/seller lookups.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | Yes | Search keyword. |
| `rh` | string | No | Amazon filter parameter (rh) for category or price filters. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/amazon-germany/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","rh":"<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.