# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-amazon-de-api-8603885c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-amazon-de-api-8603885c/get_bestsellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amazon-de-api-8603885c/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amazon-de-api-8603885c/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amazon-de-api-8603885c/get_seller_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amazon-de-api-8603885c/get_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amazon-de-api-8603885c/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","rh":"<string>"}'
```