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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-amazon-pl-api-a251afc6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-amazon-pl-api-a251afc6/get_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-amazon-pl-api-a251afc6/get_main_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-amazon-pl-api-a251afc6/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-amazon-pl-api-a251afc6/get_search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-amazon-pl-api-a251afc6/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```