# Amazon (amazon.com) — 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 Amazon products, reviews, offers, and deals, then manage your shopping cart all through a single integration. Get detailed product information, seller profiles, and best sellers to compare prices and make informed purchasing decisions.

**Category:** E-commerce | **Website:** [amazon.com/](https://amazon.com/) | **Docs:** [parse.bot/marketplace/0d501a69-44e1-46e5-95dd-419832e81fc7/amazon-com-api](https://parse.bot/marketplace/0d501a69-44e1-46e5-95dd-419832e81fc7/amazon-com-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-com-api-0d501a69/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### add_to_cart

Add a product to the cart.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Product ASIN |
| `quantity` | string | No | Quantity to add |

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

### get_best_sellers

Get Amazon Best Sellers. Returns top-ranked products from the overall best sellers list or a specific category, including rank, title, price, rating, and image.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category path segment for best sellers (e.g. 'electronics', 'books'). Defaults to 'zgbs' for the overall best sellers page. |

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

### get_cart

Get current shopping cart contents.

**Estimated cost:** Metered

_No parameters required._

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

### get_deals

Get current deals from Amazon's deals page. Returns a list of products currently on sale with their ASIN, title, price, and image.

**Estimated cost:** Metered

_No parameters required._

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

### get_product_details

Get full product details for a given ASIN including title, price, brand, description bullet points, technical specifications, high-resolution images, rating, and star rating percentage breakdown.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon product ASIN (10-character alphanumeric identifier, e.g. 'B09V3KXJPB'). |

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

### get_product_offers

Get all seller offers for a given ASIN.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Product ASIN |

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

### get_product_reviews

Get customer reviews for a given ASIN. Extracts reviews displayed on the product detail page including author, rating, title, body, and date, plus overall rating summary.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon product ASIN (10-character alphanumeric identifier, e.g. 'B09V3KXJPB'). |

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

### get_seller_profile

Get seller profile details and ratings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `seller_id` | string | Yes | Amazon seller ID (alphanumeric, e.g. 'A2CY5PUJKHLV') |

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

### search_products

Search for products on Amazon by keyword. Returns paginated results with product title, price, rating, and image. Supports optional category filtering, sort order, brand filtering, and filtering to only Amazon-sold items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | No | Filter results by brand name (e.g. 'Schylling', 'Anker'). Case-sensitive as passed to Amazon's refinement filter. |
| `category` | string | No | Amazon department/category code passed as the 'i' parameter (e.g. 'electronics', 'books'). |
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | Yes | Search keyword (e.g. 'usb cable', 'laptop'). |
| `sold_by_amazon` | boolean | No | When true, filters results to only products sold by Amazon.com (excludes third-party marketplace sellers). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-com-api-0d501a69/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","category":"<string>","page":"<integer>","query":"<string>","sold_by_amazon":"<boolean>","sort":"<string>"}'
```