# Amazon (Poland) — 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 products across Amazon Poland to find categories, product details, pricing, and current deals. Get real-time suggestions and access promotional offers to help you discover and compare items on the Polish Amazon marketplace.

**Category:** E-commerce | **Website:** [amazon.pl/](https://amazon.pl/) | **Docs:** [parse.bot/marketplace/a251afc6-01c6-41b3-b08b-71630df9aa50/amazon-pl-api](https://parse.bot/marketplace/a251afc6-01c6-41b3-b08b-71630df9aa50/amazon-pl-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-poland/`
**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 deals

Fetch current deals from the Amazon.pl goldbox/deals page. Returns a list of deal products with ASIN, title, URL, price, currency, and image. The deals list changes frequently as Amazon rotates promotions. When currency is specified, only deals priced in that currency are returned (amazon.pl prices are in PLN). Omitting currency returns all deals regardless of price availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | Filter deals to only those priced in the specified currency code (e.g. "PLN"). Case-insensitive. Omitting returns all deals. |

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

### Get main categories

Extract all top-level product categories from the Amazon.pl navigation menu. Returns category names and internal menu IDs. Categories are stable; the list changes only when Amazon restructures its Polish storefront.

**Estimated cost:** Metered

_No parameters required._

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

### Get product details

Fetch product details by ASIN from Amazon.pl. Returns title, price, brand, rating, image URL, and product page URL. Uses search-based lookup with direct product page fallback. Returns input_not_found if the ASIN does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon product ASIN (alphanumeric product identifier, typically 10 characters). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/amazon-poland/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 search autocomplete suggestions for a query prefix from Amazon.pl. Returns a list of suggested search terms useful for discovering popular product keywords and refining search queries.

**Estimated cost:** Metered

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

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

### Search products

Search Amazon.pl for products by keyword. Returns paginated product listings with title, price, ASIN, and product page URL. Each page returns up to ~48 results. Pagination via integer page number starting at 1.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword or phrase. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/amazon-poland/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.