# Amazon (Italy) — 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 retrieve product data from Amazon Italy (amazon.it), including listings, detailed product info, category hierarchies, and bestseller rankings.

**Category:** E-commerce | **Website:** [amazon.it/](https://amazon.it/) | **Docs:** [parse.bot/marketplace/95878171-7d43-4c62-94e2-49571a580c58/amazon-it-api](https://parse.bot/marketplace/95878171-7d43-4c62-94e2-49571a580c58/amazon-it-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-it-api-95878171/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_best_sellers

Get best-selling products for a specific department on Amazon Italy. Returns up to 30 ranked products with title, ASIN, price, and rating. Use get_categories to discover valid department slugs. Omitting the department returns the overall best sellers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `department` | string | No | Department slug from get_categories (e.g. 'electronics', 'books', 'pc', 'toys'). Omitting returns the overall best sellers. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-it-api-95878171/get_best_sellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"department":"<string>"}'
```

### get_categories

Get the top-level product category hierarchy from Amazon Italy. Returns category names, URL slugs, and links to the bestseller page for each department. Use the slug values as input to get_best_sellers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-it-api-95878171/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_details

Get comprehensive details for a specific product on Amazon Italy by ASIN. Returns title, brand, pricing, specifications, bullet points, images, and ratings. Some fields may be null if not available on the product page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (10-character alphanumeric product ID, e.g. 'B0DSGDJLG4'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-it-api-95878171/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asin":"<string>"}'
```

### get_search_results_csv

Search products and return results sorted by price ascending. Returns the same product fields as search_products but pre-sorted by price. Useful for finding the cheapest options for a given keyword.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'smartphone', 'cuffie bluetooth'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-it-api-95878171/get_search_results_csv \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_products

Full-text search over Amazon Italy product listings. Returns products matching the keyword with title, price, rating, and ASIN. Optionally sort by price ascending. Results are from the first page of search (up to ~48 products). Sponsored listings are excluded.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'laptop', 'cuffie bluetooth'). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-it-api-95878171/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","sort":"<string>"}'
```