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

## Access

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

## 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/parse-amazon-se-api-290fa399/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amazon-se-api-290fa399/get_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amazon-se-api-290fa399/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amazon-se-api-290fa399/search_renewed \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","sort_by":"<string>"}'
```