# Amazon (Sweden) — 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 Amazon Sweden for products by keyword with pagination support and retrieve detailed product information including prices, ratings, reviews, availability, and images by ASIN. Get autocomplete suggestions to refine your searches and discover products more efficiently.

**Category:** E-commerce | **Website:** [amazon.se/](https://amazon.se/) | **Docs:** [parse.bot/marketplace/290fa399-e0c4-4bc3-afd7-fcfe20d84810/amazon-se-api](https://parse.bot/marketplace/290fa399-e0c4-4bc3-afd7-fcfe20d84810/amazon-se-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-sweden/`
**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

Retrieve detailed product information by ASIN. Attempts the direct product page first; if blocked, falls back to an ASIN search. Full details include brand, features bullet points, product overview table, variant data, high-resolution images, availability status, and renewed condition data when the product is a Renewed listing. Fallback returns summary fields only (title, price, rating, reviews).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (e.g. 'B09ZY5LM3C') |

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

### Get suggestions

Retrieve search autocomplete suggestions for a query prefix. Returns keyword suggestions as displayed in Amazon's search bar dropdown. Useful for discovering popular search terms and related queries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search prefix to get suggestions for (e.g. 'lapt' or 'iphone') |

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

### Search products

Full-text search over Amazon.se product listings. Returns up to 48 products per page with pagination support. Each product includes ASIN, title, price, rating, review count, image, and deal badges. Pagination fetches additional pages server-side; limit caps total items returned across all pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. Will fetch multiple pages as needed. |
| `page` | integer | No | Starting page number (48 items per page) |
| `query` | string | Yes | Search keyword (e.g. 'laptop', 'headphones') |

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

### Search renewed

Search strictly within Amazon.se Renewed listings. Returns refurbished products filtered to the Renewed condition category only. Each result includes the renewed price, optional RRP (crossed-out new price), rating, and Prime eligibility. Results are auto-iterated across pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (48 items per page) |
| `query` | string | Yes | Search keyword (e.g. 'iphone', 'laptop') |
| `sort_by` | string | No | Sort order for results. |

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