# Amazon (India) — 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 for products on Amazon India and retrieve detailed information including search suggestions, product details, and bestseller listings. Get instant autocomplete recommendations and access comprehensive product data to compare prices and features across the Indian marketplace.

**Category:** E-commerce | **Website:** [amazon.in/](https://amazon.in/) | **Docs:** [parse.bot/marketplace/bfc89291-39a6-46f5-bc2b-628cfd065151/amazon-in-api](https://parse.bot/marketplace/bfc89291-39a6-46f5-bc2b-628cfd065151/amazon-in-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-in-api-bfc89291/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_bestsellers

Retrieve Amazon Bestsellers list for a category. Returns ranked products with title, price, rating, and image. When no category is specified, returns overall bestsellers spanning multiple sub-categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category path slug (e.g. 'electronics', 'books'). Empty string for overall bestsellers. |

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

### get_product_details

Extract detailed product information from an Amazon.in product page including title, brand, price, features, images, availability, and customer reviews when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (ASIN) of the product. |

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

### get_product_reviews

Extract customer reviews for an Amazon.in product. Returns up to 13 reviews visible on the public product page, optionally sorted by most recent date. Each review includes rating, title, body, author, date, and verified purchase status. The dedicated reviews page requires authentication, so this endpoint extracts all reviews embedded in the public product page (typically 8-13 reviews depending on the product).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (ASIN) of the product. |
| `sort_by` | string | No | Sort order for reviews. Accepts 'recent' (sorted by date, newest first) or 'top' (default Amazon relevance order). |
| `star_filter` | string | No | Filter reviews by star rating. Accepts '1', '2', '3', '4', or '5'. Empty string or omitted returns all ratings. |

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

### get_search_suggestions

Get search autocomplete suggestions for a given query prefix on Amazon.in. Returns keyword and widget-type suggestions with metadata.

**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-in-api-bfc89291/get_search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_products

Search for products by keyword on Amazon.in. Returns paginated results with product summaries including title, price, rating, and image.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword. |

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